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Featuring A Ready-To-Use 
Electronic Postman for: 
Database Construction 
Systematic Search & Sorts 
Personalized Mass Mailing 

Special Apple, Atari, Commodore, 

IBM, & Tl Software: 

Assembler For A Song 

Living Cell 
Bio-Simulation 

File-Shuffling 
Management Tricks 

: Serf City Econo-Fun 
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MISSING ANY VALUABLES? 

If you're missing any back issues of HS^COMPUTER" 
you're missing more than you'll ever know . . . ► 

Having each issue of Home Computer Magazine 
readily at hand provides you with direct access 
to a valuable reference library of 
home computer knowledge 
— unequaled anywhere! 




A valuable reference library of 

each Home Computer Magazine issue 

is the One Essential Peripheral™ for 

your home computer. 




ON DISK™ and ON TAPE™ 
are the convenient, accurate 
and affordable ways to save 

hundreds of typing hours. 



I 



Back Issues of HCtVTs program service 
-ON DISK™ or ON TAPE™ 
are also available. 

Collect all programs from each 
magazine issue on a ready-to-RUN 
quality floppy disk or cassette tape 
available in separate versions for 
Apple, Atari, Commodore, IBM, 
and Texas Instruments. 

SPECIAL CLOSE-OUT SALE! 

ALL 4 BIG ISSUES SHOWN ON THE OPPOSITE PAGE 

(Vol. 4 No. 1, Vol. 4 No. 2, Vol. 4 No. 3, Vol. 4 No. 4) 

DELIVERED TO YOUR DOOR FOR ONLY $5. 

USE REGULAR BOUND-IN ORDER FORM TO WRITE-IN SPECIAL SALE ORDER. 
No phone orders less than $10 accepted. Limited-Time Offer— While Supplies Last. 




"Safeguard" Your Home Computer Knowledge- 
Order Valuable Back Issues Today! 



To Order, Use Bind-In Card at Center of Magazine. 



HCM BACK ISSUES 



. . and discover 
what's in store 

for you— 

an extraordinary 

resource value! 



Issue 4.1: 

Premier Issue * Uncle Larry's Fiddle Tunes * 
Electronic Sheet Music * Music In Mini Memory * PCjr: 
A Look inside the Peanut's Shell * 66 Keys to Graphics 
Success: A Primer for the Commodore 64 * Have No 
Fear: Assembly Language Won't Byte f Part 3 * Porsches 
and other Pipedreams: Computer Assisted Savings * 
3DI!e: Apple Graphics In Three Dimensions, Part 1 * 
Biting Into Your Apple * Don't Be A SlowPOKE * Down 
Memory Lane: Don't let programmable characters gob- 
ble up your memory * Easy As Pie: Apple programming 
for Intricate works of art * Microcomputer Accuracy * 
What Is LOGO? * Lyrical LOGO * LOGO Shoots for the 
Moon; A lesson In structured problem-solving * Product Reviews " Flak Attack 
" Slots * Meltdown * Challenging the Tower of Hanoi " HCM TECH NOTES: 
Apple. C-64, IBM, and 99/4 A • Product News * Group Grapevine, and much, 
much more! 

CONTENTS: ON TAPE™ & ON DISK™ 




Flak Attack (A,C,I,T) 

Air-to-ground battle game 

Applesoft 3D (A) 

Apple graphics in three dimensions 

Tower of Hanoi (A.Cl.T) 

An ancient brain teaser 

Saving (A,C,I ) 

Computer-assisted savings plan 

LOGO Poet (A.C \ I ) 

Recursion frees the poet In your console 

LOGO Apollo (C, T) 

A lesson In structured problem-solving 



Slots CD 

An Intriguing Las Vegas simulation 

Uncle Larry's Fiddle Tunes (C, 1, T) 

Play ten beloved fiddle tunes 

Music Magic (TX) 

"Joy to the World" in harmonious BASIC 

Musk Assembler CT) 

Assembly language simplifies composition 

Autosprite (C) 

Routines to keep your graphics lively 

Meltdown {TX) 

Debug the reactor and save the world 



HOME COMPUTER 



Issue 4.3: 

Productivity T Snap-Calc: A Homespun ready-to-use 
spreadsheet * Bars and Plots: Create colorful graphic 
charts of your records ' Elementary Addition and Sub- 
traction for the 99/4A and C-64: A powerful children's 
learning tool * Spider Graphics: Spin a colorful web on 
screen • Convertible for Comfort: Automatically convert 
your machine-language programs to DATA statements 
* Programming: The Name of the Game: Designing your 
own game — a complete tutorial * Colorfun on your 
VIC-ZO * Product Reviews * Binary Forest: Branching 
out with LOGO ' LOGO Flakes: Creative explorations 
with snowftake designs * Robochase * Cyber-Clpher * Wild Kingdom * Speeder 
* Boolean Brain * Missile Math * HCM TECH NOTES: Apple, C-64. IBM. and 
9 9/4 A * Product News * Group Grapevine, and much, much mora! 

CONTENTS! ON TAPE™ & ON DISK™ 




Snap-Calc (A, C. 1. TX) 

Home sweet spreadsheet 

Robochase (A. C. I ) 

Run from the rampaging robots 

Spider Graphics (A. 1 : 

Spin a myriad of rainbow filaments 

Boolean Brain (A, I ) 

A graphic Adventure inside computers 

Wild Kingdom (A. C. J, TX) 

Flee ferocious felines 

Missile Math (A, C. I. T) 

Launching grade-school arithmetic 



Binary Forest (A. CM) 

Branching-out with leafy LOGO trees 

Bars it Plots ft) 

Color your chart factfuily 

Cyber-Clpher CT) 

Decode correct color combinations 

Elem. Addition & Subtraction (C. T) 

BASIC preschool arithmetic skai-buBder 

LOGO Flakes (D 

Snowflakes in June"? This must be LOGO 

Convertible for Comfort (C) 

Machine Language DATA auto-con version 



VERSIONS SUPPORTED: 

Machine 
APPLE tl Family (A) 
Atari (At) 

(coverage commenced with Issue 5.5) 

COMMODORE 64 (C) 
IBM PC/ PCjr (I) 
TI-99/4A (T> 



Media 

ON DISK™ 

ON DISK™/ ON TAPE 11 

ON DISK™/ON TAPE 1 ' 

ON DISK™ 

ON DISK™/ ON TAPE" 



= No ON TAPE™ available, even If normally supported 
TX = Extended BASIC programs only 
PCjr s Available for PCjr only 

Apple owners: Please note that ON DISK™ Media for HCM 
A, 1 -4.3 is In DOS 3.3 format only, and all Apple programs 
beginning with HCM 4.4 are in ProDOS format. All pro- 
grams will RUN on a 64K Apple II + (with Applesoft BASIC 
in ROM), an Apple //e, or an Apple He. 
Apple & IBM "clone" owners: Some HCM programs may 
not RUN (without modification) on your machines, because 
of differences in hardware and for BASIC Interpreters. 



Issue 4.2: 

Graphics " Sea of States * San Francisco Tourist * 

Building Your Character: A Graphics Editor for the 
VIC-20 * Quick Pixel Tricks: A Graphics Editor for the 
C-64 * Follow the Bouncing Ball: On the rebound with 
graphics fundamentals * 3DIIe: Apple Graphics In Three 
Dimensions, Part 2 * Double Your Color, Double Your 
Fun: Sprites try on a layered look * Musical Mystery 
Words * Matrix Muncher * Elementary Addition and 
Subtraction for the VIC-20 ■ IBM Animation: Controll- 
ing the pallet on the PCjr * Jr. Sounds Off: Access Jr's 
Special Sound Enhancements * The Electronic Home 
Secretary * FUes In LOGO * LOGO Spans the Generation 
Gap: A review of Commodore LOGO • FROGO: LOGO Invades the Arcade " 
Product Reviews * Tablut * Cannibals * HCM TECH NOTES: Apple, C-64, IBM, 
and 9 9/4 A * Product News * Group Grapevine, and much, much more! 

CONTENTS! ON TAPE™ & ON DISK™ 




Cannibals (A, C, I, T) 

Livingston Stew, I presume? 

FROGO m 

A logical LOGO learning lesson 

The Home Secretary (A, C, I, T) 

Address St inventory recordkeeping 

LOGOFILES (A, C ' , I, T) 

Access your DATA files In LOGO 

See of States (C. TX) 

State Capitals and dive for booty 

Tablut (C. I, TX) 

1 4th-century strategy revisited 



Matrix Muncher (O 

Solve unknowns simultaneously 
Graphic Editor (Q 
Pixel tricks create easeful graphics 
Mystery Words (A, t ) 

Reading between the treble clefs 

PCjr Animation (PCjr) 

Exploring Junior's graphic modes 

Applesoft 3-D lie (A) 

Edit your 3-D graphic shapes 
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Issue 4.4: 

Computer Sports * lie: The Core of a New Machine * On 
the Home Court: Computer Sports Simulation * Razxle 
Dazzle: Quick Graphics Magic for the 99/4A * Simon Sez: 
Plug In 1 1 4 new BASIC commands to the Commodore 
64- * Tax Deduction Filer: A complete tax recordkeep- 
ing program convinces you that makes tracking of deduc- 
tions a breeze * Kaleido Computer: Creating a myriad of 
mosaic designs on your home computer * Multiptan 
Medium, Part 8 * Have No Fear: Assembly Language 
Won't Byte, Part 4 * The RS-232 Interface: Understan- 
ding Your Link to the Periphery ' One for the Money, 
Two for the Slow — Adding a Second Drive to the PCjr * Missionary Impossible: 
A Logic Puzzle In LOGO pits you against hungry Cannibals * Product Reviews 

* Boolean Brain * Stadium Jumping * Market Madness • Elementary Addition 
and Subtraction: An arithmetic tutor (for Apple and IBM PC and PCjr systems) 

• HCM TECH NOTES: Apple. C-64. IBM and 99/4A * Product News * Group 
Grapevine, and much, much morel 

CONTENTS! ON TAPE™ & ON DISK™ 



Boolean Brain (C. TX) 

A graphic Adventure Inside computers 
Tax Deduction Filer (A, C, 1. TX) 
SAVE-Ing with your tax deductions 
Market Madness (A, C, I, TX) 
Exciting Stock market simulation 
Stadium Jumping (A, C, I, T) 
Horsing around an Olympic Stadium 



LOGO Spreadsheet (A. C * . I, T) 

And you thought LOGO was kldstuff 

Missionary Impossible (A. C\ I, T) 

Watch out for Cannibals with LOGO 
Elem. Addition & Subtraction (A, I } 
BASIC preschool arithmetic skill-builder 
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Issue 4.5; 

Building Up Your Software Library " Qute Construction 
Set: Create a Quiz or Take a Quit — a must for students 
and teachers * Personal Loan Calculator: Find out where 
your interest lies * Jumping Ahead With Game Program- 
ming: A complete game programming tutorial Includes a 
program example * Sketch -64: Joystick graphics with 
just a flick of the wrist * Simon Sez: New string-related 
commands explained * Razzle Dazzle: Character 
manipulation on the 99/4A * Division Tutor: Teaching 
BASIC math learning skills * Putting The Puzzle AH 
Together: Apple lie Programming Considerations * Bird 
Brain * Slither ■ LOGO Clones: Tl Graphics In a Turtle-Shell * Build A LOGO 
Adventure, Part 1 * Product Reviews ' HCM One Liners ■ HCM TECH NOTES: 
Apple. C-64, IBM, and 9 9/4 A * Product News * Group Grapevine, and much, 
much more! 

CONTENTS: ON TAPE™ A ON DISK™ 




Bird Brain (A. C, I, T) 

Keep your fishing feathers dry 
Division Tutor (A, C, I. TX) 
Expand elementary math skis 
Personal Loan Cak CA, C, I, T.) 
rind out where your interest ties 
Sketch-64 (O 

Use a Joystick to draw graphics 
Qui* Construction Set: 
Quli-Make/Quiz-Take (A, C, I, T) 
Complete tutorial with file examples 



Peg Jump CA, C, J, T) 

Learn BASIC game programming 

Slither (A, C, I, T) 

A maze of snake-Uke proportions 

LOGO Clones CD 

Tl-Graphlcs tn a Turtle-Shefl 

LOGO Adventure CA, I, C) 

Pt, I : Creating Interactive fiction 




Issue 5.2: 

Number Crunching: The Building Blocks of All Computing 
* It Figures: An equation calculator that'll crunch your 
numbers accurately " Evacu-Pod: See If you can rescue 
all the miners In this challenging space game * Switch 'n' 
Spell: Electronic anagram brain teasers to puzzle over 
(for children, and adults) * Laserithmetlc: Strut your 
math skill with this space fantasy edu-game * Organizer 
Reports: An enchancement to print-out your organized 
thoughts (see The Organizer HCM 5.1) ■ Razzle Dazzle: 
Tinker with musical sounds, or Play It Maestro! * What 
Is CP/M?: Learn the Basics of Control Programming for 
Microcomputers * Apple Seedlings: Sorting out your ProDOS Catalog * Com- 
modore Hornblower: Discover what's inside the Commodore 64's SID chip * 
lBMpresslons: Create 3-D surface drawings In BASIC * Field & Screen: A tutorial 
for using a Data Base System — correctly * Product Reviews * HCM One Liners 
* HCM TECH NOTES: Apple, C-64. IBM, and 99/4A ' Product News, and much, 
much more! 

CONTENTS: ON TAPE™ & ON DISK™ 



Evacu-Pod (A, C, I, TX) 

Miner rescue in space 

It Figures! CA. C, 1, TXJ 

A mighty equation calculator 

Laserlthmetic (A, C, I. T) 

Blast aliens with your math skills 

Organiser Reports (A. C \ I, TX * ) 

Print your organized outlines 



Switch 'n' Spell CA, C, I, T> 

A spelling aid that's fun to boot 

Apple Seedlings CA) 

Sort your ProDOS catalogs 

Commodore Hornblower (O 

Inside the SID chip 

lBMpresslons CI ) 

3-D surface drawing In BASIC 




Issue 5.4 

Time Management: Computer- Assisted Efficiency Comes 
Home " Run-Day-View: Let your computer streamline 
your day ' Trkj-Trix: Use the triangle as a measuring tool 
' Archeodroid: Participate In a future archeologlcal dig 
* Mine Over Matter: Hone your business skills in this 
simulation of uranium mining operations * MAC-ROs: 
Create custom graphic shapes on Macintosh ■ lBMpres- 
slons: Create your own computer windows * Razzle 
Dazzle: Explore sound-on-sound recording with this 
3 -track recorder program * Apple Seedlings: Use a pie 
chart as a visual aid * Commodore Hornblower: Change 
filters on the SID chip * Algorithm- A-Tricks: Create Invisible ripples * Speeding 
up a BASIC Program: Part 2 * Build a Logo Adventure: Part 4 * Product 
Reviews * HCM One Liners * Home Computer Industry Journal ' Product News 
• HCM TECH NOTES: Apple, C-64, IBM, and 99/4A, and much, much more! 

CONTENTS: ON TAPE™ & ON DISK™ 



Run-Day-VEew IA. C, I. T) 

Organize your dally schedule 

Trig-Trix CA. C. I, Tl 

The triangle makes measurement easy 

Archeodroid CA. C, I. T) 

Join a future archeoiogical dig 

Mine Over Matter CA. C. I. T) 

Manage a uranium mine 

LOGO Adventure, Pt. 4 (A, C, I ) 



Apple Seedlings (A) 
Creating pie charts 
Commodore Hornblower CO 
Changing filters on the SID chip 
Apple Tech Note CA) 
Exiting error routines 
Commodore Tech Note CO 
Merging programs from tape 
IBM Tech Note ( I ) 
Using special character graphics 



NOTE: 
Programs for 
the IBM PC/PCjr 
will run on the 
Tandy 1000 
with modifica- 
tions specified 
on page 1 30. 




Issue 5.1; 

Thought Processing: A New Frontier In Home Computing 
* The Organizer: Store and organize your thoughts * Or- 
bital Defender ' Quiz -Print/Quiz- Print Tutorial: This educa- 
tional enhancement Is a tool for use with your Quiz Con- 
struction Set (see HCM 4.5) * Electronic Backgammon; 
A modern version of an ancient game of skill * Razzle 
Dazzle: Screen patterns with graphics characters on the 
9 9/4 A " Kors-Elf: An Arcade Typing-Tutor Game * Per- 
sonal Loan Calculator: Find out where your Interest lies 
■ Apple Seedlings: A ProDOS Date-Setting Utility * lBM- 
presslons: Create a beautiful pie chart " Build A LOGO 
Adventure. Part 2 * LOGO Sailing: A Premier Yachting Event * Simon Sez: Com- 
posing music Is simple ■ HCM TECH NOTES: Apple, C-64, IBM, and 99/4A * 
Product News * Group Grapevine, and much, much more! 

CONTENTS: ON TAPE™ & ON DISK™ 



Orbital Defender (A, C, I, T) 

Split-second battle dedstons 

Electronic Backgammon CA, C ( I, TX) 

Pit your pips against the computer 

Kors-Elf CA, C, J, TX) 

An arcade typing adventure 

The Organizer (A, CM. TX*) 

A versatDe Thought Processor 

Quii- Print CA, C. I. T) 

Format printouts of your quizzes 

Apple Seedling CA) 

BASIC utility dates ProDOS files 



LOGO Adventure (A. C '. I ) 

Pt. 2: Creating Interactive fiction 

Merging Files CO 

Experienced hackers only! 

Personal Loan Calc CT) 

Find out where your Interest lies 

Razzle Dazzle CT) 

Wormwood your character graphics 

LOGO Salting CD 

Turtles race for the America's Cup 

lBMpresslons ) 

Create a beautiful pie chart 
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Issue 5*3 

Computerized Budgeting: Featuring a ready*to*use 
CPWUpfrtf JL^ budget processor CBudgetron) * Honing your Geometry 

skills CGeometrlx) • LOGO Adventuring (Build A LOGO 
Adventure, Pt, 3) " Survive a nuclear plant disaster 
(Over-Reaction) * Guard the seaways with nuclear sub- 
marines (Torpedo Alley) ' Turtles race with Zeno's 
theory (Achilles and the Turtle) * Apple Seedlings: 
Character graphics on the hl-res screen * Commodore 
Hornblower; Select waveforms and envelopes from SID 

* Razzle Dazjle: Multi-layered animation with Tl sprites 

* lBMpresslons: Blending sign waves Into complex pat- 
terns * MAC-ROs: Expanding BASIC on Macintosh * Speeding Up a BASIC Pro- 
gram * Product Reviews * HCM One Liners * Group Grapevine * Product News. 
' HCM TECH NOTES: Apple, C-64. IBM. and 99/4A, and much, much more! 

CONTENTS: ON TAPE™ & ON DISK™ 




Budgetron (A, C, I, T3 

Budget your income and expenses 

Geometrix { A. C, I, T ) 

Sharpen your geometry skills 

Over-Reaction ( A, C. I. T ) 

You're at a nudear plant's controls 

Torpedo Alley ( A. C, l, T ) 

Keep the enemy's ships at bay 

Achilles & the Turtle £ T ) 

A LOGO demonstration of Zeno's Theory 

LOGO Adventure, Pt. 3 { A. C * . I ) 



Apple Seedlings ( A ) 

Character graphics In hl-res 
Commodore Hornblower t C ) 
Waveforms fi envelopes from SID 
Apple Tech Note ( A ) 
Key-In checking routine 
IBM Tech Note ( I ) 
Selective keyboard input 
Commodore Tech Note I C ) 
Merging programs from disk 
Tl Tech Note { T ) 
A full-screen editor 




Issue 5.5 

Memoranda Processing: Computer-Assisted Cor- 
respondence Made Easy * NanoProcessor: Explore your 
computer's language * Electronic Typewriter; Make your 
computer act like an electronic typewriter * Tl Car d-Trix: 
Deal out organization on 3x5 file cards * The Plains of 
Salisbury: Help King Arthur save Camelot * Vital Signs: 
Control cardiovascular functions with this simulation * 
Apple Seedlings: Blend frequencies with your Apple * 
Commodore Hornblower: Create special SID sound ef- 
fects * lBMpresslons: Explore 3-D shadow graphics * 
Atari Atrium: Make your own "big" sounds with this 
sound-on-sound recorder ' Razzle Dazzle: Crunch numbers down to the 1 Oth 
decimal * Algorithm- A-Tricks: Learn the mathematical secrets behind Vita! Signs 
' Soundbytes: Merge music and electronics * Product Reviews * HCM One-Liners 
* Home Computer Industry Journal * Product News * HCM TECH NOTES: Ap- 
ple. Atari, C-64. IBM. and 99/4A, and much, much more! 



CONTENTS 

NanoProcessor ( A, R. C. I. T ) 

Learning your computer's language 

Electronic Typewriter ( A, R, C. I ) 

The computer typewriter 

Tl Card-Trlx ( T ) 

Organize with file cards 

The Plains of Salisbury ( A, R, C. I, 

Battling for Camelot 

Vital Signs ( A. R. C. I. T ) 

A "hearty" lesson 



! ON TAPE™ & ON DISK™ 

Apple Seedlings { A 1 
Blending frequencies 
Commodore Hornblower ( C ) 
Sound effects on SID 
IBMpressions 1 1 ) 
Shadowing 3-D graphics 
T ) Atari Atrium ( R ) 

Recording sound-on -sound 
Razzle Dazzle ( T ) 
Calculate quick and easy 



Atari users 
please note that 
coverage In HCM 

didn't commence 
until this issue. 
Also commencing 
with this issue, 
programs for the 
IBM PC/PCjr run 
as is on the 
Tandy 1000. 



HCM BACK ISSUES 



FOR NEW READERS 






The Plain & Simple Truth 

About HOMEfOM PlfTBT 






Chock Full of Valuable Software & 
How-To Articles Without Filler 

Every issue is a software "horn of plenty" with dozens 
of type-in-and-RUN programs printed in an easy-to-read 
listings format. Our programs are also available on 
inexpensive disks or cassettes for those who prefer the 
convenience of ready-to-RUN software. Step-by-step 
tutorials round out each issue, providing the solid facts 
you need without fluff or filler. Thus, each issue 
functions as an excellent reference work, as well as a 
valuable software source. 

No Outside Advertising 

Freed from the pressures of servicing advertisers, we concentrate 
on serving our readers. Each issue provides uninterrupted editorial 
flow and graphic layouts for better comprehension— plus unbiased 
product reviews which focus on true strengths and weaknesses, 
wherever the chips may f all . . . And we don't have to worry about 
losing advertisers because of publishing software in the magazine 
that is "too good." Consequently, we can provide the best free 
software available anywhere. 

Focused on the 5 Hot Home Brands 

We are 5 system-specific magazines under one wrapper— not a 
sprawling, "general interest" publication which attempts to cover 
too wide a field, only to spread itself too thin. The other side of 
the coin to this focused approach is the knowledge you gain from 
being exposed to the many tips, ideas, and techniques we provide 
for 4 of the 5 systems you may not even have. You'll learn more 
about your Apple, Atari, Commodore, IBM, or Texas Instruments 
home computer from this one magazine than from a host of more 
limited sources. 

A Balanced Mix For a Perfect Recipe 

In each issue we strive for a perfect balance of productivity, 
entertainment, education, utilities, and computer literacy— serving 
the needs of novice and pro alike. Every issue is a full-course meal, 
with a smorgasboard of tasty dishes for all palates. Whereas other 
computer magazines may dish out lumps of "editorial indigestion," 
we serve up a satisfying blend— one digestible byte at a time* 



— Welcome to Our World of Home Computing 



Home Computer Magazine (ISSN 0747-055X) is 
published ten times per year by Emerald Vaffey Publishing 
Co.. P.O, Box 70288, Eugene. OR 9740 L The editorial 
office is located at 1500 Valley River Drive, Suite 250. 
Eugene, OR 97401 (Tel. S03-48S-8796). Subscription rates 
in U.S. and its possessions are S25 for one year, $45 for 
two years, and $63 for three years. In Canada add S7 per 
year. Other foreign countries $43 for one year surface 
mail. Inquire for air delivery. Single copy price in U.S. and 
its possessions is $3.50, and $4.50 in Canada. Foreign 
subscription payment should be in United States funds 
drawn on a US bank. Second-class postage paid at Eugene. 
OR 97401, and Columbia. MO 6520 f, 
POSTMASTER: Send at! address changes to Home 
Computer Magazine. P. O. Box 70288, Eugene, OR 
9740 1 . Subscribers should send all correspondence about 
subscriptions to above address. 

Address all editorial correspondence to the Editor at 
Home Computer Magazine. 1500 VaMey River Drive, 
Suite 250, Eugene. OR 97401 . Unacceptable manuscripts 
mil be returned if accompanied by sufficient first class 
postage and self-addressed envelope, Not responsible for 
lost manuscripts, photos, or program media. Opinions ex- 
pressed by the authors are not necessarily those of Home 
Computer Magazine. Alt mail directed to the Editor or 
to the "Letters to the Editor" column will be treated as 
unconditionally assigned for publication, copyright purposes, 
and use in any other publication or brochure, and are sub- 
feet to Home Computer Magazine's unrestricted right 
to edit and comment. Home Computer Magazine 
assumes no liability for errors in articles, programs, or 
advertisements. Mention of products by trade name in 
editorial material or advertisements contained herein in no 
way constitutes endorsement of the product or products 
by Home Computer Magazine or the publisher unless 
explicitly stated. 

Each separate contribution to this November 1985 issue 
and the issue as a collective work is Copyright © 1985 by 
Emerald Valley Publishing Co. All rights reserved. Copying 
done for other than personal or internal reference use 
without the permission of Emerald Valley Publishing Co, 
is prohibited. Requests for special permission or bulk orders 
should be addressed to the publisher. 
Limited License for use of programs in Home Com- 
puter Magazine. Emerald Valley Publishing Co. (EVP) is 
the owner of all rights to the computer programs and soft- 
ware published in this magazine. To allow for use of the 
software by the purchaser of the magazine, EVP grants to 
such purchaser only, the limited license to enter these pro- 
grams into the purchaser's computer, and to place such 
programs on a diskette or cassette for the purchaser's per- 
sona! use. 

Any other use, distribution, sale, or copying of these com- 
puter programs without the written consent of EVP is ex- 
pressly prohibited and in violation of this limited license and 
the copyright laws. 

Home Computer Magazine, H CM, Home Computer Indus- 
try Journal, and Music & Electronics are trademarks of 
Emerald Valley Publishing Co. 

Publtsher/EditorinChtef Gary M; Kaplan 
Executive Editor David G. Brader 

Managing Editor Walter Hego 

Associate Editor Wayne Koberstein 
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William K. Balthrop, Roger Wood 
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Patricia Swift, Randy Thompson, 

Steve Weersing, Andy Widders-Ellis, 
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Assistant Editors 
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Jeff Harper, Galen Huntington, 

James Jentile, Ross Johnson, 

Robert Paschelke, Francis Saffell 
Production Manager Norman Winney, Jr. 

Creative Director Get-Lei Gom 

Photography 

Nelson Stevens, K.D. Wainsworth 
Customer Service Tel. {503) 341-1029 

Dealer Sales & Distribution TeL {503} 341-1036 
Main Switchboard TeL (503) 485-8796 




Zappp! With the crack of a lightning bott, the power 
of electronic mailing comes to the home computer. 
And to the home user, this new power may come 
as a pleasant surprise— like the pop-up greeting card 
depicted on our cover. Especially in the Holiday season, 
most of your correspondence may be as personal as 
this card. But when your mailing list grows, your com- 
puter can apply the speed of electricity to turn that 
lengthy list into a whole stack of personalized greetings, 
ready for the mailbox. Such useful software is the 
"hallmark" of Home Computer Magazine— so , look 
to us. We deliver the mail! 




As electronic tools have accus- 
^ktomed us to quick— if not 
/ \ instant— transfer of information 
nearly anywhere on the globe, we have 
come to expect this magical ability as 
part of everyday life. Meanwhile com- 
puters have helped speed every level 
of communications—from the latest 
video transfer, right on down to one of 
the earliest forms of civilized cor- 
respondence: the mail. 

In this issue, we present the Eleo 
tronic Postman himself— a software 
enhancement to last issue's Electronic 
Typewriter. This modern hero will strike 
through all the tedium of personal 
"mass mailing" (just in time for the 
Holidays!) and still convey your personal 
touch. 

To communicate your personal 
power, take charge of Serf City, an 
economic strategy game set in medi- 
eval times. This two-player simula- 
tion—pitting one feudal kingdom 
against another in a race for greater 
prosperity— will surely test your Mach- 
iavellian skills. (Remember: In Serf City, 
"hang ten" means to hang ten serfs!) 

Communication is basic to life 
itself— as you can see in Cell Mates, a 
software simulation of a dynamic living 
cell. Here, you take the part of the 
nucleus, communicating life-preserving 
messages to our internal symbiotic 
partners: the organelles. As you learn 
to direct this cellular dance, its very 
complexity may surprise and awaken 
you to another great mystery of life. 

To communicate a complex idea is 
one thing— to make it simple enough 
to understand is another. For as you 
will be able to learn from this issue's 
NanoAssembler (a companion to 
NanoProcessor of last issue), simplicity 
underlies all complexity. Using a simple 
model of a computer's workings to 



simulate its complex works, this second 
Nano article shows how to use a 
human-like "assembly" language to 
communicate in terms the machine 
can understand. 

After communicating our main HCM 
"software instructions," we dedicate 
specific program/tutorial columns to 
each computer brand. In this issue, 
Apple Seedlings creates three-dimen- 
sional waves on a simulated pond's sur- 
face; Atari Atrium breeds sine-wave 
hybrids; Commodore Hornbiower ad- 
dresses SID in BASID; IBMpressions 
grows a binary forest; Razzle Dazzle 
evokes some startling sound effects 
from the 99/4A. And, for all machines, 
Problems in Productivity brings one of 
our star programs from the past into 
the arena of everyday life. 

In our review section, we try to com- 
municate the real truth about specific 
products in the computer marketplace: 
How much hassle is it to add more 
memory? How speedy is this speed- 
reading course? Can your computer 
help you cook up simple financial ad- 
vice? Can software programs teach you 
the secrets of the earth? Or will they 
help you reach for the stars? 

Electronic communication may seem 
so commonplace to us that it takes 
something special to reveal the magic 
of electronic media— something as spe- 
cial as music. So as you enjoy our regular 
editorial fare, take time also to explore 
this issue's special inserts: the Cornu- 
copia Sound Sampler and Cornucopia 
Catalog of electronic musical instru- 
ments. We think this is sound advice. 

In the Electronic Age, the most 
powerful instrument— for any kind of 
communication— is your computer. 
And at Home Computer Magazine, we 
always aim to keep your home 
machines well in tune. 



until next time, have fun reading, learning, and RUNing 
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"I've been discussing the part computers are starting 

to play in personal music creation and performance 

—now, I get to literally put my music 

where my mouth is. " 



Good news. We have a special 
audio-visual surprise for you. 
As you know, over the last 
couple of issues I've been discussing 
the part computers are starting to 
play in personal music creation and 
performance— now, I get to literally 
"put my music where my mouth is." 
As narrator of the special bound-in 
Cornucopia Sound Sampler, I'm 
proud to introduce the exciting new 
field of computer-orchestrated elec- 
tronic music into your livingroom. 
And to enhance this educational ex- 
perience, we've prepared an infor- 
mative Cornucopia Catalog of 
musical product offerings. This 
16-page supplement and our 
6-minute stereo recording are the 
first steps in providing the crucial in- 
formation that will help home com- 
puter users like yourselves to par- 
ticipate in this new electronic music making.* 

For best results when playing this stereo recording, I 
suggest that you first place a regular LP record on your 
turntable platter, and then lay ourSoundsheet on top of 
it. May I also suggest that you read this issue's Sound- 
bytes column; it should help put the relationship between 
home computer usage and music participation into bet- 
ter perspective. 

Once you've played our Soundsheet on the best stereo 
system you can muster up, please audition the recording 
for whomever you think may be interested. Don't forget 
to show them the catalog too. 

Anyone entering the world of musical electronics will 
need a source of timely, accurate, and reliable informa- 
tion. Music & Electronics* our new sister publication, is 
that indispensable source. We're now in the midst of a 
major drive to gain subscribers to this unique magazine, 
and we need your help. Of course, we're also hoping that 
many more of our present HCM readers will choose to 
join us on this exciting new journey. 

Producing and distributing a recording and catalog like 
this takes a great deal of money. We'd like to think that 
it's worth it. So, won't you please drop me a line telling 
how you like (or dislike) our efforts. If you'd like to see 
more of these special inserts, and have ideas for other 
state-of-the-art products you'd like to see carried, please 
let me know. Producing a publication like Home Com- 
puter Magazine without revenue from outside advertis- 
ing isn't an easy task. If our readership does, in fact, sup- 
port our Cornucopia product offerings, it makes it that 
much easier for us to increase the quality of this 
magazine's content. 




O; 



n another score (pun partly in- 
tended), this issue features 
some special enhancement soft- 
ware and the premiere of our 
Problems In Productivity column. 
I'm especially pleased to have had 
the opportunity to participate in the 
creation of such a unique, 
challenging— and badly needed- 
magazine feature. This new col- 
umn is a direct result of the reader 
feedback I asked you for a few 
issues ago. This kind of exchange 
is what the reader-publisher rela- 
tionship is— or should be— all 
about. And I, for one, would like to 
see a lot more of it. So please keep 
your feedback mail coming in. It's 
crucial in the process of "tuning" 
HCM to your changing needs. 

You will notice that in this issue, 
two of our featured programs are 
"software enhancers"— separate utilities that add 
valuable functions to our previous stand-alone programs, 
turning them into even more powerful, versatile 
packages. Electronic Postman and NanoAssembler are 
important milestones in our continuing quest to bring 
you the best possible software within the constraints im- 
posed by magazine-delivery economics. If you like this 
approach, be sure to let us know as soon as possible— 
quite a bit of lead-time is necessary to design and imple- 
ment multi-issue software packages. 

Although the reported marketing machinations 
surrounding Atari's new 16-bit 520 ST system con- 
tinue to perplex us, we are nevertheless pleased over the 
preliminary response to last issue's expansion into the 
Atari 8-bit world— the 800, 800XL, and 130XE. It's evi- 
dent from early feedback that HCM has a lot to offer the 
Atari user— valuable material not available elsewhere for 
so reasonable a cost. It's also obvious that, so far, we've 
only just scratched the tip of the iceberg in making the 
large Atari user base aware of HCM' s new coverage. I hope 
that many of you will take the initiative to help us get 
the word out. And while you're at it, please don't forget 
to tell all your friends with IBM-compatibles (such as 
Tandy, Zenith, etc.) and Apple-compatibles (Franklin) 
that HCM now also serves them too. Because we don't 
have the "big bucks" for expensive ad campaigns, our 
subscription marketing effort depends on your help. 
We're here today because of your past support. So, please 
continue to lend us a hand— come grow with us. 



*N0TE TO HCM READERS OUTSIDE THE U.S. 

Because we are presently unable to ship product orders from outside of the continental 

U.S., the Cornucopia Catalog is not included in nor* U.S. distribution. However, Canadian readers 

will receive the bound-in stereo recording to provide tnern wrth a "sound" reason for subscribing 

to the audiovisual version (magazine plus companion audio cassette) of Music & Electronics. 
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96 HCM Glossary 
- DeBugs on Display 

(No Debugs This issue) 
Home Computer Tech Notes: 

42 Apple 

43 Atari 
48 Commodore 

56 IBM 

57 Tl 



SPECIAL End-Of-Year 

Warehouse Clearance Sale 
On Selected Back Issues of HCM 

4mmm see inside front cover 

LIMITED-TIME OFFER 
ORDER TODAY! 

Unequaled Value-Don't Miss Out! 



MACHINES SUPPORTED 



Machine 

APPLE II family 



FRANKLIN ACE 
ATARI 800 T 800XL, 

130XE 
COMMODORE 64 
COMMODORE 128 
IBM PC 
IBM PCjr 
TANDY 1000 
TI-99/4A 



Requirements 

At least 64K RAM 

& Applesoft BASIC 
At least 64K RAM 

-None- 

■None- 

Must be in 64 mode 

BASICA 

Cartridge BASIC 

GW-BASIC Version 2.02 

Tl BASIC or Extended BASIC 



Media 

ON DISK 
ON DISK 

ON D1SKJON TAPE 

ON DISK/ON TAPE 

ON DISK/ON TAPE 

ON DISK 

ON DISK 

ON DISK 

ON DISK/ON TAPE 



SPECIAL NOTES 

Apple Owners: Apple ON DISK media for HCM, vol. 4, No. 1-VoL 4, 
no. 3 Is in DOS 3.3 format only. Beginning with HCM, vol. 4, 
No. 4, all Apple programs are In ProDOS format. All programs 
RUN on Apple li +, Apple //e r or Apple lie computers. 

Franklin Owners: Beginning with HCM, vol. 4, No. 4, all Apple 
ON DISK media Is In ProDOS format only. Booting ProDOS on 
a Franklin requires the following steps: 

1. Boot ProDOS, When the system hangs up, press (RESET). 

2. Type 265B:EA EA and press (RETURN). 

3. Type 2000C (Insert no spaces between the last zero and 
the C) and press (RETURN]. 

see HCM, vol. 5, no. 4, page 13 for more Information. 
Tandy 1000 Owners; starting with HCM t vol. 5, No. 5, all of our 
IBM PC programs run on me Tandy 1000 without modifica- 
tions. Programs prior to vol. 5, no. 5 may need minor changes 
as explained on page 130 of hcm, vol. 5, no. 4. 



Errata 
Atari computer Users: Due to an oversight In our software that 
translates program format to typeset listings, line 390 of the 
NanoProcessorln HCM vol. 5, No. 5 mistakenly contained an English 
Pound symbol (£). This character should have been a backslash (\), 
which you produce by pressing (shift] + on the Atari computers 
keyboard. 

Attention Subscribers: 
To avoid missing any valuable Issues, please check the address label 
for maturity of your subscription— so you can be sure to renew 
before It expires. 



Atari Saves A Reader 
Dear Sir: 

Today I received your magazine and much 
to my surprise, I found thai you have added 
Atari to the micros covered. I must tell you that 
I was an old TI subscriber who had upgraded 
to the Atari and though I found you a source 
of good info and programs when I had theTI, 
I was going to let my subscription lapse— not 
now! 

Enclosed please find a check for $5.95 for 
the Atari disk with the programs from Vol. 5, 
No. 5. If you can produce the great data, info, 
and programs that I know you have had in the 
past, not only will I renew, but I will talk to 
some of my friends and show them what you 
are all about. 

Keep up the good work, and I and a million 
(or more) other Atari owners will flock to buy 
your magazine. I especially am fond of your 
tutorials and short programs which are usual- 
ly both instructive and entertaining. 

Alex Pignato 
Oceanside, Long Island, NY 

Alex, your letter is typical of the positive 
response we have received to our new Atari 
coverage. We are already beginning to see the 
vanguard of that flock you speak about. We 
want all the Atari users out there to know that 
the roost is ready at Home Computer 
Magazine. So, fly on over! 

Better Sequential Saver 

Dear Sir: 

I am a proud owner of a Commodore 64 and 
enjoy HCM very much. In last month's issue, 
Mike Poole explained how he used the C-64 
merge program to convert sequential files to 
a usable program. I think I have come across 
an easier way to make a sequential file a usable 
program. Just type LOAD' 'PROGRAM 
NAME,S>\8. The sequential file is loaded in- 
to memory and can be saved as a program file. 

You can also save a program as a sequential 
file by putting (,S) at the end of the file name 
when saving a program. This serves as a form 
of protection from those who don't know about 
this trick. If you put (,U) at the end of a file 
name when saving a program, the program will 
be listed as a user file in the directory. The pro- 
gram can then only be loaded with the ,8, 1 end- 
ing. I hope this information is useful to some 
HCM users because it has been very useful to 
me. 

Bert Palmer 
Address unknown 

Well Bert, saving a program with the ,S ex- 
tension does not actually change the format of 
the file— it is still a program file. This method 
does, however, place the SEQ identifier next 
to the file. Thus, even though the directory con- 
tains the SEQ, it is possible to load a program 
file saved in this manner because the file is still 
in program format. Your method does not 
work with program files that were listed to disk 
as sequential text files (see "HCM Bug-Out' " 
for details on how this is done), and therefore 
not in tokenized format. The program must be 
in tokenized format for the LOAD statement 
to work properly. As for program protection, 
using the extensions ,S and ,U is a great little 
trick. Who would think that a "SEQuential 
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file' 7 was actually your latest programming 
masterpiece? And better yet ; who would think 
to LOAD it? Thanks for the tip Bert. 

Creative Cursoring On Apple II 
Dear Sir: 

Did you ever wish that you could change the 
Apple's cursor without any special routines? 
Well, I have. On an Apple, screen memory is 
larger than the actual screen. I guess it was easier 
to just make it an even 1 -K. The leftover bytes 
are either unused or are used for special func- 
tions. Location 2043 (decimal) is the value of 
the cursor (its ASCII value + 128). If you 
POKE this location with the correct number, 
it changes the cursor to whatever you want. For 
example, 

POKE 2043,ASC<"_")+ 128 
will produce a blinking underline cursor. This 
cursor remains until you POKE 2043 with a dif- 
ferent number or press [CONTROL] [RESET]. 
If you put the actual ASCII value here, the 
character will be in a flash mode in addition 
to the normal cursor blink. Am 1 the only one 
who didn't know this, or is this an important 
find? 

Donald W. Scott, Jr. 
Address unknown 

Donald, you We found something that we 
haven 't seen documented before— but don *t try 
to get it to work on an Apple without 80-column 
capability. The location you are POKEing is one 

that is part of text-screen scratch -pad RAM 
used by expansion slot 3 or the auxiliary slot 
on the Apple He. Apparently, this location is 
used by the 80-column card to determine the 
cursor character, even when the computer is not 
in 80-column mode, which explains the little 
trick you We uncovered. 

Who Adds Most To PCjr? 

Dear Sir: 

As an owner of the PCjr, I have several ques- 
tions that are in urgent need of reliable answers. 

1 . There are five sources (Tecmar, Quadram, 
Impulse, Racore, Legacy) of second-drive 
enhancements with memory expansion for the 
PCjr, but what are the special features of each? 
How does each of them increase the PCjr's 
compatibility? 

2. Can the PCjr utilize the 8087 math- 
coprocessor? (For example, the Micro Way 
8087 math-coprocessor for PCjr.) 

3. Is there any other internal modem besides 
the one sold by IBM that the PCjr can use? 

4. How is Racore's DMA controller board 
utilized by the PCjr? Does it make the PCjr 
more compatible? 

5. Because of the PCjr's lack of DMA, in- 
tense I/O and downloading of large files are 
close to impossible. Would the DMA controller 
board by Racore eliminate such problems? Also 
would it allow the disk drive and the CPU to 
work simultaneously? 

Wen J. Chen 
Flushing, NY 11355 

Over several issues, we have reviewed the 
Tecmar jrCaptain (Vol. 4, No. 4), Legacy II 
(Vol. 5, No. 2), the Quadram Expansion (Vol. 
5, No. 4)— and, in this issue, both the Microsoft 
and IBM PCjr memory expansion systems. In 
this last article, you will find a chart compar- 

Volume 5, No. 6 



ing the features of all these products. We are 
currently examining the Racore version of the 
previously reviewed Quadram product and will 
publish a review in an upcoming issue. We are 
also looking at the Impulse product and the 
Racore DMA controller as future review hems. 
In addition, our technical staff is researching 
the feasibility of installing an 8087 in the 
PCjr— look for an HCM report in an upcom- 
ing issue, 

TI LOGO II Cartridge Sought 

Dear Sir: 

I would like to buy theTI LOGO II cartridge. 
I have been looking for a place to buy the car- 
tridge, but cannot find one. Could you help me 
out? I would greatly appreciate it. Thank you. 
Roman L, Schmitz 
Malone, WI 53049 

Roman, we've traced down a few sources for 
you. TI LOGO II is currently available from: 
TexComp(P.O. Box 33084, Granada Hills, CA 
91344) for $20.00; Unisource (P.O. Box 64240, 
Lubbock, TX 79464) for $69.95; and Triton 
Products (P.O. Box 8123, San Francisco, CA 
94128 ) for $19.95. Other local or regional 
sources may also carry this product. 

Disenabling Break Key? 
Dear Sir: 

To disenable the break key on the IBM com- 
puter, this program works: 

10 POKE 108,64:POKE 10,1:POKE 
110,1 12:FOKE 111,0 

I tried this program on the Tandy 1000— it 
did not work. Another way to trap the break 
button on the IBM is this program: 

10 KEY 17, CHR$(4) + CHR$(7):KEY (17) 
ON;ON KEY (17) GOSUB 100 

20 REM REST OF PROGRAM HERE 

90 REM 

100 PRINT "BREAK BUTTON 
INOPERABLE' ( :RETURN 

This did not work on the Tandy 1 000 either. 

I hope you can solve my problem. Thank you. 

Darren Eichorn 

Hatboro, PA 19040 

Darren, the BREAK key on the IBM is func- 
tion key 1 7, and is therefore redefinabie as you 
have detailed. The Tandy machine does not 
allow redefining of the function keys above 12. 
Consequently, no similar fix that we know of 
will work on that machine. Are there any Tan- 
dy programmers out there who've been able to 
perform this feat of magic? 

Program Prompts Purchase 
Dear Sir: 

I bought a computer simply because of your 
program "The Organizer.' 1 I had wanted 
"Think Tank," but knew it would only run on 
Apple or IBM PC machines and, in addition 
to its price (approximately $125), I felt the 
overall system costs of these two machines were 
above my means at this time; but when I saw 
the "The Organizer" would run on the Com- 
modore 64, I then bought a second-hand 64 
(and your software)! I have not yet tried it out, 
so my enthusiasm may be premature, but at 
least I've gotten my feet wet. 



I would like more technical things and fewer 
games. Also separate loose-leaf documentation 
that we could order from the magazine, for ease 
of use and safety (cheap of course). I appreciate 
the documentation in the magazine, but the 
magazine will be hard to use everyday and I 
will have to make a photocopy, 

I notice there seem to be quite a few programs 
exclusively for the Apple or IB Ms, I hope Com- 
modore doesn't discontinue the 64, 1 would like 
to see more 64 programs in your magazine. 

The program listings in your magazine are 
help f u ! e ven i f I don ' t key t h em i n , I f you print 
updates on the programs I use, I will have to 
be able to find the lines easily. 

Thanks for innovation! 

Lin Sinclair 
Alameda, CA 94501 

Thank you, Lin, for the compliments and 
advice, Actually, if you look more closely, you 
should find that our magazine content is even- 
ly balanced between all the machines we cover 
You can check this out yourself by counting 
through the Program Listings Contents on page 
71. As for technical material, almost everything 
we publish contains a wealth of technical 
information— e.g., our Programmer's Win- 
dows for all major programs (including games), 
plus Tech Notes, tutorials, and reviews of 
specialized products. We try to balance this 
material against lighter content for less tech- 
oriented computer users, A word about the 
"games" we do publish: We have recently 
shifted our approach to computer gaming away 
from the arcade to simulations with some 
educational— as well as entertainment— value. 
Your suggestion of providing separate software 
documentation is interesting and deserves con- 
sideration. Anyone else out there want to see 
this? Good luck with your new computer, Lin, 
and have fun! 

MousePaint: Look But Don't Print? 

Dear Sir: 

1 think your magazine is marvelous. We just 
recently purchased an Apple lie computer and 
have bought two of your Home Computer 
Magazines (Vol. 5, No. 2 and Vol. 5, No. 3). 

My question to you has to do with my printer 
and my mouse. It seems I can't get the Mouse- 
Paint pictures I drew to print on my Star Gemini 
10x printer with the PAC interface. We've tried 
everything and hope you can shed some light 
on the subject. Will you please explain what 
might be wrong? Is the problem in my printer, 
interface, or MousePaint disk? 

I was wondering if you were planning on put- 
ting more arcade-style programs in your 
magazine in the future. I also think you should 
arrange your magazine into sections, like put- 
ting all the Apple software in one section, C-64 
software in another section, and so on. This 
would really help me and probably all the other 
subscribers a lot. 

Roger Thompson 
Reeds Spring, MO 65737 

In order to send a MousePaint drawing to 
a printer, you need an interface and printer 
combination that will dump the high-resolution 
graphics screen. From what you say, it doesn't 
sound like your interface-printer combination 
can do this. We've had excellent success using 



the Grappler + from Orange Micro (1400 N. 
Lakeview Avenue, Anaheim, CA 92807) and 
an Epson MX-80. (See "Mousing Around on 
the Apple U" in HCM Vol 4, No, 4 for details.) 
As to your question about separating the 
magazine into sections: If you look at the issues 
following Vol. 5, No. 3, you will see that we 
have indeed phased in a system of marking the 
magazine in easy-to-identify content sections, 
Special "edge-tab" markers flag each major 
section. Documentation for all major programs 
(those with versions for all 5 computer brands 
we cover) appears in the first section marked 
"Software Instructions." This is followed by 
a section of "Product Reviews," then 
"Tutorials" (including separate columns for 
each computer brand), the "Programmer's 
Windows, ' ' and finally the * 'Type-in Listings ' ' 
section. We hope this will be a very handy- 
quick -reference guide for you and others who 
have requested similar tab-indexing. 

To DeBug, Or Not To DeBug . . . 

Dear Sir: 

As a new subscriber to HCM I wish to tell 
you how pleased I am with your magazine. I 
purchased the first issue I ever saw at a magazine 
stand and was surprised at the amount of in- 
formation I was able to understand and use. 
I am a newcomer to computers and have a 
TI-99/4A computer with a TI Expansion 
system, 32K memory board, RS232 interface 
and Extended BASIC. I am still not sure of how 
to make the most of this system, but am en- 
joying every moment at the keyboard. 

After going through Vol. 5, No. 3, I called 
your 800-number and ordered a one-year 
subscription, and backorders of Vol. 5, Nos. 
1 and 2 ON DISK. They have just arrived and 
after reading instructions on how to update the 
disks (I am referring to The Organizer program) 
and a little trepidation, I began. Then to my 
utter surprise, I discovered that the updates had 
already been done to Vol. 5, No. 1 ON DISK. 
Did I somehow miss some information as to 
these updates being made automatically, and 
if so, can you explain the procedures for when 
and if updates are needed? 

I realize that Texas Instruments is no longer 
making the TI-99/4A, but I am sure that there 
are many other new users who might appreciate 
some articles that are geared for beginner users. 
I am referring to some of the lesser-used func- 
tions such as PEEK, INIT, LINK, DEF, etc. 
When do you use them, and examples in short 
programs? How about a LOAD program to 
automatically boot your disks? 

Thanks for a terrific magazine which is giv- 
ing me hours of pleasure. 

Sylvia Kesten 
Northridge, CA 91326 

Glad to have you on board, Sylvia. After 
checking the introduction to our DeBugs sec- 
tion, we can understand your confusion. Sure 
enough, we do not specifically communicate 
this fact: ON DISK issues always contain the 
latest debugged ^and enhanced— versions of 
each program as they are shipped. In addition, 
the most recent ON DISK issue will also con- 
tain an "update file" of the latest DeBugs, for 
those who received any previous issue before 
all its DeBugs appeared in print. These files can 
be merged with programs on the older, non- 
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updated disk. If you want to ascertain whether 
your disk contains the latest updated programs 
or whether it requires merging in update files, 
compare the program 's version number on your 
ON DISK issue to the version number of the 
latest DeBug as it appears in print. If the 
numbers are the same, your version contains 
all the latest DeBugs; you do not have to merge 
it with an update file. 

We have— and will continue to— run articles 
that demonstrate specific ' 'PEEK and POKE' ' 
kinds of programming methods. For the 99/4A, 
check out "Razzle Dazzle," a regular tutorial 
column that beginners can learn from. 

Putting A Second Drive Into Junior 
Dear Sir: 

As a loyal reader of HCM for several years, 
I am pleased to see that you arc still keeping 
readers up-to-date on happenings with the PCjr. 
As you probably know, most other magazines 
concerning the PCjr discontinued publication 
when production came to a halt. All PCjr 
material which I have read in HCM is always 
very helpful and beneficial to me. 

Now I need special help! Shortly after I pur- 
chased my PCjr, I bought an Okidata printer. 
Next, I purchased theTecmar jrCaptain, With 
these new additions, I have been able to utilize 
my PCjr for something other than playing 
games. My problem is this: I would like to pur- 
chase a second disk drive. I already own a 
clock/calendar, a printer port, and have ex- 
panded memory to 640K, I have shopped 
around, looking at the Legacy and other sys- 
tems, and am very disappointed because I don't 
want to pay hundreds of dollars for a second 
drive which adds features that I already own! 
All I want is a second disk drive— nothing else! 

Please help me locate a second drive for my 
Junior, where I don't have to pay for un- 
necessary features. 

Stephanie Fox 
Brick, NJ 08723 

At HCM we have several PCjr's with second 
disk drives, Stephanie— and they are completely 
compatible with the Tecmar jrCaptain. (For 
specifics on how a second drive and the Tec- 
mar product work together, see the letter from 
Ron Sutherland in HCM VoL 5, No., 3,) We 
installed these drives ourselves using the method 
described in the article entitled "One For The 
Monev, Two For The Slow: Adding A Second 
Disk Drive To The PCjr' ' in HCM Vol. 4, No, 
4. You may wish to get a copy of this issue (see 
HCM Back Issues in the front of this magazine), 
and see if this solution fits your needs. The kit 
described in the article allows you to modify 
your PCjr disk controller card to support a sec- 
ond drive, and is available from our order 
department for $49.95 plus $3,50 for shipping 
and handling. 

Seeking C-64 Interface 
Dear Sir: 

I have read your fine magazine since the Vol. 
4, No. 1 issue, especially for the Commodore 
64 articles and the Letters to the Editor column. 
This question is directed to that column: What 
inter face{s) will work best with the Commodore 
64 and the Gemini- 10 (not the new I Ox)? One 
that would give complete Commodore 1525 
emulation? 
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After many unanswered letters from printer 

interface companies, I'm hoping the answer to 

this question shows up in your Letters to the 

Editor column. Thanking you in advance. 

Richard L. Wightman 

Wellsville, NY 14895 

There are so many good interfaces* Richard, 
we don 't know where to begin, Cardco (300 S. 
Topeka, Wichita, KS 67202) has several quali- 
ty interfaces that make the Gemini- 10 emulate 
a 152S. If all you do is word processing, the 
?/B or 7/PS Cardco interfaces should suit you 
fine. If you want something with graphic 
capabilities, the ?/G -f from Cardco is an ex- 
cellent choice. Both The Connection from 
Tymac Controls Corporation (127 Main Street, 
Franklin, NJ 07416) and Super Graphix from 
Xetec (3010Arnaold Rd. Salina t KS 67401) pro- 
vide 1525 emulation with graphics. 



Making Room For Mac 
Dear Sir: 

I have noticed that your last two issues of 
Home Computer Magazine have had a section 
called "MacRos" for the Apple Macintosh. 
After seeing these articles I have two basic ques- 
tions for you. First, are you going to continue 
to support the Macintosh? Will you broaden 
the coverage? I hope you will, especially since 
the Macintosh is a member of one of the 
families you are supporting. (When IBM in- 
troduced its PCjr, you immediately started to 
support it!) 

The second question deals with the MS- 
BASIC for the Macintosh. If you start to sup- 
port the Mac, will you provide programs for 
it? 1 know that the MS-BASIC version for the 
Mac is similar to the MS-BASIC for IBM. If 
so, it would seem to be easy enough, even 
without color. Please consider what I have sug- 
gested, I really am interested in buying a Mac 
and I would like your magazine to cover it in 
the same style which you have covered the other 
computers, I am sure that other readers share 
my view — so please consider it. 

Brian Neidig 
Taylor, TX 76578 

Brian, we have run several features for the 

Mac in recent issues to see what kind of response 
we would get from home users. We have to say 
that the response— though positive— was 
sparse. Your letter is one of the very few we 
have received from Mac users. This is not to 
say that— given more requests—we won f t cover 
the Macintosh in the future. But to include Mac 
versions of all our major programs, we would 
need to make space in the magazine by deleting 
something else or increasing our total page 
length— a costly alternative in either case. 
There's also another consideration, Brian. Ap- 
ple just recently canceled its long-worked-on 
MacBASIC. Our plea to the Apple for bunding 
the languages with all Macs is now moot. At 
its present price in the SI 50 range, we feel that 
Microsoft 's BASIC for the Mac is too costly 
a package for a large enough user base to 
develop. Without the necessary numbers, an 
expansion to full Mac coverage just doesn't 
make economic sense. 
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99/4A Lock-Up 

Dear Sir: 

I own a TI-99/4A and have been having pro- 
blems with the computer locking up. I have been 
told that it is normal for it to happen once in 
awhile, but it locks up much more than it 
should. The cartridge that locks up the most 
is Extended BASIC. When I plug in the Ex- 
tended BASIC cartridge and then select choice 
#2 for Extended BASIC the screen will 
sometimes fill up with random symbols. 

It also locks up with other cartridges. For 
example, in the middle of a chess game with 
the computer, the computer will sometimes lock 
up. This problem appears to be either in the 
cartridge plug-in or where the peripheral expan- 
sion system plugs into the speech synthesizer 
or possibly where the speech synthesizer plugs 
into the keyboard. 

I have written many letters to different com- 
panies and nobody seems to be able to figure 
out my problem. 

Any help you could give me will be 
appreciated. 

Kip A. Dondlinger 
Hutchinson, KS 67502 

Kip, you have just hit on two of the 99/4 A 's 
trouble spots. The cartridge slot and the side 
port are very susceptible to wear and tear. The 
side port, in particular, can give users many 
headaches. To help minimize your own 
headaches, make sure that the console and ex- 
pansion box cable are on a flat, level surface. 
Problems start arising if the expansion cable 
doesn 't fit just right into the side port. The side 
port can also be a problem if your console 
moves around on the table top. Any time the 
console moves, the connection between the con- 
sole and the expansion cable can weaken. If this 
is a problem, try putting double-sided tape 
under the feet of the console to keep it from 
slipping. Finally, the cartridge port is quite often 
the culprit in a lock-up. Extensive plugging and 
unplugging of cartridges would cause even the 
most expensive connectors to wear out in a very 
short time. Unfortunately t it would require 
some technical expertise to disassemble the car- 
tridges and/or your console to clean the con- 
tacts or, in severe cases, to replace the contacts. 
The best solution to this problem is to minimize 
the number of times that you switch cartridges. 

Ask And Ye Shall . . . 
Dear Sir: 

I don't own an Atari 800XL computer 
anymore. I sold it because it didn't stand up 
to my Tl . Why don't you cover the Atari com- 
puters? There are more Atari 800s and 800XLs 
than PCjrs, not to mention Atari 400s, 600XLs 
and some !200XLs. If you added Atari's line 
of computers to your magazine you would real- 
ly see a jump in your subscriptions and sales. 
If space is a problem why not just drop the 
PCjr? (I know that will make a lot of people 
angry and upset, so let me apologize now to 
any offended person.) 

Also you have HCM one-liners. Why not 
HCM graphics? There are many people who 
would love to show off their still and moving 
graphics programs. I feel you should let your 
faithful readers know the answers to these 
questions. 

Frank DeCandia 
Jersey City, NJ 07307 
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There's no need to drop a very fine machine 
like the PCjr, Frank. We ha ve kept Junior and 
also added more pages for Atari coverage. As 
you can see from Mr. Pignato's letter (Atari 
Saves A Reader) above, we are already start- 
ing to reap the benefits of this new coverage. 

In regard to your second question, our 
"HCM One-Liners" page generally includes 
outstanding graphics submissions. In addition, 
our specialty articles - like Tl ' 'Razzle Dazzle ' ' 
and "Atari Atrium " — make perfect showcases 
for such programs. If you have an original pro- 
gram that you f d like to show off, send it to us. 
We welcome any article and program 
submissions— graphics or otherwise. 



For IBM PC Sans Graphics Board 
Dear Sir: 

I recently bought a copy of your magazine 
at a newsstand thinking I would enjoy running 
several of the programs offered, I found, 
however, that I couldn't use any of the pro- 
grams because my IBM PC is not equipped with 
a graphics card. I bought the computer for data 
management (text) and word processing, so a 
graphics card is unnecessary (and would cost 
about $500). Wouldn't it be possible with a pro- 
gram like Budgetron to have an alternative ver- 
sion for machines without graphics? If not, then 
your publication is of no use to someone like 
me, which seems a pity. 

Thank you for your attention. 

Katherine A. Kirk 
Victoria, BC, Canada 

Katherine, the architecture of the IBM PC 
is unlike other computers such as the Apple. 
The IBM BASIC interpreter only supports 
graphics commands when the graphics adapter 
is installed. We feel that color is an essential 
part of good home-user software. Because both 
the IBM PC and PCjr are such great color- 
graphics machines, we don 't want to limit our 
readers to monochrome-only programs. 
Without the graphics interface installed ', our 
programs would be limited to text only. 
Whenever a program runs best with the card, 
we consider it a system requirement. Budgetron 
is an excellent example: it will run without the 
graphic adapter card, however the bar-graph 
option results in an ILLEGAL FUNCTION 
CALL. If you don't select this option, the pro- 
gram will work just fine. After running some 
tests, we have determined that the following 
programs will run on the IBM PC without a 
graphics adapter— with limitations as noted. 
Vol. 4 , No. 2: Electronic Home Secretary 
Vol. 4 , No. 3: Snap-Calc and Missile Math 
(without space ship graphics) 
Vol. 4, No. 4: Basic Addition and Subtraction 
and Tax Deduction Filer 
Vol 4 t No. 5: Division Tutor, Personal Loan 
Calculator, Quiz-Make, and Quiz-Take 
Vol 5, No. I: Quiz-Print, all Organizer 
programs 

Vol 5, No. 2: FNkey, Organizer Reports, It 
Figures! 

Vol. 5 t No 3: Geometrix (with limited graphics), 
Budgetron (no bar graph option) 
Vol. 5, No 4: Run-Day-View, Trig-Trix (with 
limited graphics) 

Vol 5, No. 5: Electronic Typewriter, Bug-Out 
Vol 5, No. 6: Electronic Postman 



Bug-Out Identifies Bugs 

Dear Sir; 

I own an Atari 800XL with a single disk 
drive, a tape recorder, and a very dotty matrix 
primer. I have previously owned four other 
computers, all of which were ignored, for the 
most part, by the publishing industry. It was 
really nice to see the support for my machine 
at last. 

This reaction is tempered a little after a cou- 
ple weeks of (intermittently) typing programs 
from your magazine! The first thing I typed 
in was the Proofreader, and I must admit that 
it worked. The second thing I undertook was 
the NanoProcessor and my experience was not 
so great. 

The first problem arose when I tried to enter 
line 920, a DATA item with a clear and un- 
mistakable Pounds-Sterling symbol. Atari X 
models have such a symbol; however, the use 
of it normally excludes the other graphic 
characters used in the NanoProcessor display. 
I eventually figured out that what you must 
have meant was a SHIFT + character used (by 
Atari mostly in other languages than BASIC) 
for mod division. 

The second problem was rather more of a 
bug, and took a while to figure out. The pro- 
gram checks the location 764 for last key 
pressed, and branches accordingly, At least, it 
ought to; it doesn't. The problem seems to be 
well illustrated by the segment from line 1500 
to 1580. The variable B contains the last-key- 
pressed identity from location 764; line 1520 
tries to match it against the ASCI I value of the 
control-panel keys. But the Ataris use three in- 
terlocking character set designations: ASCII; 
Internal code, which is the sequential position 
of the character in the shape table; and 
Keyboard code, which bears little resemblance 
to the other two. Keyboard code is tied to the 
row-column position of the keys, and it is a 
member of this set which is stored at 764. Here's 
a one-liner for you to illustrate the point: 
1 FOR A= 1 TO 256:A = PEEK(764): 
?CHR$<A);" ";:NEXTA 

PLEASE type it EXACTLY as shown. The 
continuous reassignment of the counter variable 
value within the loop keeps the thing going 
forever, or until you have had enough (use 
BREAK to get out). Press any key, alone or 
with either or both of CONTROL and SHIFT 
keys. Try the Atari key (inverse toggle) and the 
CAPS, ESC, and RETURN keys. Try using 
each key with and then without the CONTROL. 
Try any key presses you like. CTRL-1 which 
pauses all action and then unpauses it, and the 
BREAK key will not give unusual results. 

But back to the program bug. 1 thought of 
looking for the keys that would give the result, 
in effect reassigning the control panel in the 
game. Almost immediately after that, I thought 
of altering line 1 580 so that the correct connec- 
tion with ASCII would result, Both of these 
approaches had to be rejected because not all 
ASCII values represent valid keycodes. Not 
even all 6- or 7-bit numbers are valid. As a mat- 
ter of fact, it turns out that some of the values 
required for the program are not valid K-codes, 
The only workable solution I found was to 
rewrite the following two lines. 
1520 READ ZQ: IF B = ZQ THEN 1550 
1580 DATA 49,50,51,52,60,62,80,69,6, 
73,82,76,62 



I have not yet had a chance to play with the 
program, to see whether or not it is completely 
debugged. At least these fixes get it started 

running. 

I look forward to the next few issues of your 
magazine. I hope it lives up to the high prom- 
ises made by issue 5.5, apart from these details, 
Diane Hoffman 
Oshkosh, WI 54901 

We're glad to have such a knowledgeable 
Atari reader, Diane. Thanks for the comments. 
The first bug you noted was due to an over- 
sight in our process for translating the program 
to our type-set listing format. The other bug 
seems to stem from an error you apparently 
made in typing in the program. Line 1460 does 
indeed PEEK location 764 , but B does not con- 
tain the value from that location — it contains 
the AT ASCII returned from the GET #2 f B 
statement. Thus, that aspect of the program 
works correctly as published. Thanks, though, 
for the excellent discussion of the various ways 
Atari machines represent key input, as well as 
for the neat little "one-liner." 

Word Pro From ProDOS To 3.3 
Dear Sir: 

I am having some problems with my Apple 
He. A few weeks ago, a friend of mine sent some 
documents he created with his word processor 
to me. The documents were on a ProDOS disk 
and were stored as text files. My problem is that 
most of the documents he sent to me that were 
stored as text files were stored under a sub- 
directory. My word processor can read text files 
when they are directly stored as text files, but 
not when they are stored under a sub-directory. 
My word processor translates the text files to 
files my word processor can understand. (The 
files are on a DOS 3.3 disk now because that 
is the only formal my word processor can 
translate them from. I copied the files from the 
ProDOS disk. This procedure has always 
worked until now.) Do you know of any pro- 
gram or procedure that would allow me to store 
these text files directly onto the disk instead of 
under a sub-directory so I could print the files 
on my printer with my word processor? I need 
a solution really soon. 

Also, I have heard about a Z-RAM board 
by Applied Engineering that would allow you 
to add 256 or 512K of additional memory and 
a Z-80 microprocessor to the Apple He. Their 
ad says that it comes with a RAM disk so pro- 
grams could run 20 times faster. It also said 
that you could run regular Apple software and 
CP/M software without unplugging the board. 
Do you think you could review this product? 
It sounds very interesting. 

Thank you very much for your help, 

Pete Sison 
San Diego, CA 92139 

In order to convert a Hie from ProDOS to 
DOS 3 J you need two disk drives and the Pro- 
DOS Convert utility from Apple, If you have 
these, the various sub-directories shouldn 't give 
you any trouble in con version— just specify the 
complete ProDOS pathname in the con vert pro- 
gram, We are evaluating the Z-RAM card from 
Applied Engineering and will be reviewing it 
in a future issue. 



Hard-Driving Junior? 

Dear Sir: 

Like thousands of others, I thoroughly en- 
joy your magazine. In particular, I have used 
your techniques to successfully add a second 
floppy drive to my PCjr. Now 1 wonder about 
adding a hard drive. With the rapid de- 
escalation in hard drive prices this would ap- 
pear to be a valuable next step. Any possibilities 
of your experts telling us how to do that? 1 am 
sure a number of us would benefit greatly. 
Warren T. Dent 
Indianapolis, IN 46260 

Warren, our experts are currently working 
on hard-disk drive solutions for the PCjr, so 
stay tuned to HCM for cost-effective means to 
expand your PCjr's capabilities. Also, if any 
other readers desire additional Junior 
enhancements, please let us know so we can 
work toward giving you what you need. 

Terminal Tape Troubles 

Dear Sir: 

1 recently purchased a modem through mail 
order for my Commodore 64. Somehow there 
was a mixup in my order and the company 1 
ordered from sent me the terminal software on 
disk instead of cassette tape as I requested, I 
contacted the company and they told me that 
the terminal software was unavailable on tape. 
When I borrowed a friend's disk drive to load 
the program and try to transfer it to tape, I 
found that I could only access one line of the 
program which was a SYS command. Is there 
any way I can access the full terminal program 
and copy it to tape or will I be forced to pur- 
chase a disk drive to use my modem? 

Matthew Correll 
Grinnell, IA 50112 

Buying a disk drive is not a bad idea 
Matthew— especially now that the price on the 
Commodore 1541 is so low — but it is not the 
only answer. Several fine terminal programs 
come on tape and even cartridge. The popular 
VIP Terminal from Soft la w is available on tape. 
The Ski Writer II cartridge from Prentice-Hall 
(Reviewed in HCM Vol. 5 No. 4) is both a word 
processor and terminal program. As for copy- 
ing and modifying the program you have now, 
don H try. It may be copy protected, and the 
attempt may void its warranty. If what you have 
does not work with your current system, we sug- 
gest that you either buy a disk drive or return 
the package, 

Mini-Amnesia On Mini-Memory 
Dear Sir: 

The Mini-Memory module for my TI home 
computer will not accept assembly programs 
from tape, or BASIC programs from the com- 
puter. 1 assume the battery has died. 

Could you tell me if this can be remedied and 
if so, where do I send it? How much would it 
cost? How long would it take? Have I diag- 
nosed the problem correctly? 

Any information you could send me would 
be appreciated. 

John Wood 
Salem, OR 97306 

John, it's good that you should bring up this 
subject. There are a lot of Mini- Memory car 
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iridges out there with weak or failing batteries. 
There 's a very good possibility that your Mini- 
Memory battery has finally gone to that great 
recharger in the sky. The symptoms you 
describe fit the dead-battery syndrome, though 
that doesn f t rule out the possibility that the con- 
nector could be dirty or the cartridge misaligned 
so that the pins on the card edge don 7 fit cor- 
rectly when the cartridge is inserted into the 
system. Fortunately, there is help on the way. 
We are currently tracking down the least- 
expensive sources for the battery, and will tell 
you how to replace it in next issue's "Home 
Computer Tech Note" for TL 



Personal Accounts-Payable? 
Dear Sir: 

1 have an IBM PC and I am looking for a 
computer program that will do the following 
things. I was wondering if you would have this 
on any of the disks that are available through 
you, or if you might know where I could find it. 

It is to manage my personal bills. I would 
like to be able to enter the company name, com- 
pany address, or a code number for each com- 
pany, subtract the payment made and have the 
balance show. The next month I would like to 
be able to subject the payment again and have 
the account balance show. It would work like 
an accounts payable file. 

Thank you for your help, 

Florence M. Glenn 
Santa Ana, CA 92702 

Florence, so far we have not published a pro- 
gram that will totally "fill the bill*' for you. 
We are, however, developing such a 
program— one that will not only allow the kind 
of file you suggest, but also provide great flex- 
ibility in customizing other kinds of 
alphanumeric/calculating data Hies, Look for 
this software soon in an upcoming issue. 



Looking For Artificial Intelligence 
Dear Sir: 

I will be a sophomore in high school next year 
and have acquired (through certain channels) 
a free hour each day which I spend working 
with Apple He computers. I also have a Com- 
modore 64 at home and I am planning to buy 
the new C-128 when it arrives on the market. 

My question is this: Do you know of any 
companies that specialize in literature and/or 
software on artificial intelligence program- 
ming? I intend to focus my future computer 
studies on this particular subject. 

Thank you. 

Philip G. Jones 
Slater, MO 65349 

Philip, your local library will probably ha ve 
a few major books on Artificial Intelligence 
(AI), although such books are largely non- 
technical and are targeted for the popular 
market. Most famous among these is The Fifth 
Generation, byFeigenbaum and McCorduck, 
which talks about Japan's push forAl. Others 
include: Artificial Intelligence, by L. Stevens, 
The Thinking Computer, by B. Raphael, and 
Godel, Escher, Bach, by D, Hofstader. If you 
want technical information and news of the cur- 
rent state-of-the-art, a newsletter published out 
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of Scottsdale, Arizona, called "AI Trends/* 
will fill your needs. You will find that most A I 
research these days, centers on "expert 

systems"— software that provides the kind of 
technical advice usually reserved for experts in 
a given field. For example, Hewlett-Packard 
employs an expert system on the assembly line 
to help diagnose defects in the structure of 
microchips. These programs use a combination 
of raw data bases and a "knowledge" base 
garnered by quizzing engineers on every con- 
ceivable "what-ir' situation. Some of these pro- 
fessional techniques have trickled down to the 
microcomputer level — with programs like Per- 
sonal Consultant for the TI-99/4A, Experlisp 
for the Macintosh, and the Knowledge 
Engineering System for the IBM PC. Human 
Edge Software offers a few such * 'decision mak- 
ing ' ' programs for the Apple II family; but we 
don't know of any available for the C-64 or 
the C-128. (The C-128 should be compatible 
with AI software written for CP/M systems, 
however.) As these kinds of programs become 
more applicable to home use, we will certainly 
cover them in HCM. 



A Pound Sign For A Backslash 

Dear Sir: 

Imagine my surprise. I have never looked in 
your magazine, just at the cover. This time- 
Atari I 

Your magazine seems much more im- 
aginative than most of the others, especially in 
your programs and explanation sections. I see 
an excellent relationship growing. 

However, is it just because you are new to 
the Atari field? Your NanoProcessor program 
in Vol. 5, No. 5 has a bug that can't be just 
a typo. Line 920 has a data statement which 
includes an English pound sign! I can access 
this symbol on my 800XL with the International 
Character function, but it reverts to a simple 
CONTROL 'H' graphics symbol on LISTing 
or RUNning. What did you have in mind? 

Second, I can't get the program to work. I 
have CAREfully checked my listing but when 
I RUN the program I get an Input Statement 
Error (#8) on line 820. For some reason my 
computer will not accept the line 920 data 
statements. If I remove the offending 
statements (losing the switch pointer) the pro- 
gram runs for awhile until I enter the third line 
of the sample program where I get a String 
Length Error (#5) in line 1660. 

Last, but not least, Atari Bug-Out doesn't 
DO anything! It runs, it asks for output device, 
it says READING, but it doesn't access my 
cassette file. Is it supposed to operate my 
cassette recorder? Your instructions don't say! 

I know this letter looks hyper-critical, but it's 
not meant that way. I'm super impressed with 
your first Atari issue. I know it can only get 
better. 

Norm Palosky 
Alexandria, VA 22304 

Thanks for the input, Norm, and welcome 
aboard. For the answer to the first problem you 
mentioned, see "Bug-Out Identifies Bugs" 
(above). As for the Bug-Out program, other 
readers have experienced no difficulty; we can 
only conjecture that you have made a typing 
error. 



No ProDOS-Compatibles 
Dear Sir: 

I have three different Apple II + compatible 
computers (from two different manufacturers) 
that I have been using heavily for over two 
years. I haven't had the slightest compatibility 
problem with loads of different software and 
with different operating systems, including 
CP/M and Pascal. But ProDOS doesn't work. 
None of the ProDOS diskettes that you have 
sent me works. Neither does one recently pur- 
chased program which is on a ProDOS diskette. 
The disks boot up displaying the title screen for 
the ProDOS release, then the computer locks 
up. The only key that the computer will res- 
pond to after that is RESET, which causes more 
problems. (Note: Two of the computers have 
16K RAMcards in slot 0, and the other has a 
128K Saturn board.) Is it necessary to purchase 
a ProDOS preboot diskette? Or is there some 
multiple-letter code to type in? Or has Apple 
figured out a way to defeat the "compatibles" 
with this latest operating system? 

If I'm out of luck with ProDOS, would it 
be possible for you to send me your Home 
Computer ON DISK software with DOS 3.3? 

Mike Rosa 
Peru, IN 46970 

Mike, on the second page of the Table of 
Contents in this issue, there are instructions for 
running ProDOS programs on Franklin 
machines. You don f t say which brand of Apple- 
compatible you have, so we can '{ guarantee this 
will work for you. In Vol, 5, No, 5 , a letter 
from Henry Curry provides another way of fix- 
ing a ProDOS disk for Franklin — by using a 
"Sector Editor." 



Expansion Of Coverage Hailed 
Dear Sir: 

This is the first time I have ever written to 
any magazine and I just wanted to say thanks. 
I am an avid Atari user and will help support 
anyone who supports Ataris. The first time I 
saw your magazine was several months ago on 
the newsstand. I was disappointed to see that 
you did not include Atari in your coverage. 

A couple of days ago, I was skimming 
through the magazine rack and saw issue 5,5 
with the small banner announcing Atari 
coverage. I immediately bought the issue. A day 
later I mailed my subscription. 

I have owned an Atari for about two years 
now. I started with the 400 and the 410 recorder, 
but now have an 800XL, disk drive, modem, 
and printer. 

Again, thanks for the expanded coverage. 

You can expect me to be a continued subscriber. 

Dennis E. Rees 

Willard, OH 44890 

Glad we are able to fill your need, Dennis. 
We look forward to bringing Atari users a 
fresh — and badly needed — approach to home- 
computer usage, hcm 




In our last issue, we introduced you to TI Card 
Trfx— a program designed to help you create and 
edit an inventory of file cards containing thoughts, 
book references, recipes, etc. Now we'd like you to meet 
Card Trix's helpful companion— TI Card Shuffler. This 
companion completes important filing functions faster 
than even the best secretary. And it lets you shuffle your 
cards between many different cross-referenced folders. 
The program begins by offering you two options: 

SEARCH CARDS 
EXIT PROGRAM 

Search Cards 

This option brings you to the heart of the program. 
You can begin indexing your cards from 4 different 
Card-Trix folders. When you select Search Cards for the 
first time, the program asks you to enter the search 
parameters you want to use to pull cards from folders. 
First, enter the item for which you are searching— any 
sequence of up to 28 characters. Then, specify the 
field(s) by which you want to search. You can search 
using the Index, Subject, and Text fields or any com- 
bination of the three fields. You must select at least one 
field, or the computer becomes irritated and beeps at 
you. Search Cards consists of these 4 options: 

GET A FOLDER 

TOSS A FOLDER 

SET SEARCH PARAMETERS 

RETURN TO MAIN MENU 

Get A Polder— When you select Get A Folder, the 
program asks for the name of the folder that you want 
to search through. After you enter the appropriate file 
name, the computer searches through the folder, noting 
all cards that meet the search parameter specifications. 
The computer then displays the number of cards, if any , 
that it finds. 

You can perform this indexing search with a max- 
imum of 4 folders in memory. If you want to search 
through a fifth folder, you must create space by discard- 
ing one of the folders with the Toss A Folder option. 

Toss A Folder— When you select this option, the 
computer displays a list of all the folders that are cur- 
rently in memory. To toss one of the displayed folders, 
enter the number that appears next to the unwanted 
folder. Don't worry: Tossing a folder does not erase it 
from the disk or cassette—only from memory. 



TI Card Shuffler 



by Randy Thompson 

HCM Staff 



Shuffle your file cards? Actually, 
compu terized card sh uf fling can help you 
organize and expand your filing capacity. 

[Note: TI Card Shuffler is the second part of TI Card Trix, 
which appeared in HCM Vol. 5 No, 5./ 

Set Search Parameters— You can change the 
search parameters with this option. If you can't find 
what you're looking for, for example, try changing the 
fields by which you are searching. 

Return To The Main Menu— When you return to 
the main menu with folders in memory, the menu ex- 
pands to offer you two more options: 

PRINT FOLDER INDEX 
SAVE INDEXED FOLDER 

Print Folder Index 

The folder index is a cross-reference listing of all the 
folders in memory. The printout contains the name of 
each folder in memory, the item used in the search for 
these folders, and numbers corresponding to the card(s) 
where the item was found. Let's say you printed a search 
for the word "DOG." Now, any time you need to find 
a card containing "DOG," simply refer to the indexed 
printout. You can also display a cross reference on- 
screen by selecting the Screen option. You can press 
the space bar to pause the screen display as it scrolls by. 

Save Indexed Folder 

Want a whole new folder instead of just an indexed 
printout? With this Save option you can shuttle cards 
from the 4 folders in memory into a new folder. 

When making a new folder, the program asks you for 
the disks or cassettes that hold the cards you want to 
shuffle. Now, insert the destination disk or cassette, and 
computer will save the indexed folder to the device with 
the file name you choose. [Note: Each folder holds no 
more than 25 cards; therefore, the program places only 
the first 25 cards it finds in the new folder.) 

Exit Program 

If you select this self-explanatory option and forget 
to make a printout or perform a search, don't worry. 
The program automatically asks you if you're sure you 
want to exit. At this point, you can either re-enter or 
exit Card Shuffler. 

HCM Glossary terms: cross-reference, Index, parameter. 

For your type-In listings, see HCM PROGRAM LISTINGS CONTENTS. 

HCM 



© Home Computer Magazine i 985 Volume 5, No. 6 



15 



I ; 



Electronic 
Postman 



by Randy Thompson 

HCM Staff 



Neither rain nor snow nor the strictest of deadlines can keep you 
from writing individualized correspondence with this mail-merging program. 



If you're like many people today, you probably write 
personalized correspondence only when you have 
to. It's a time-consuming task! And it doesn't help 
when your list of addresses and phone numbers grows 
exponentially year after year, listing friends, relatives, 
business associates, congressmen, fellow club 
members, and more. 

Frustration usually sets in when you need to contact 
all or most of these people simultaneously for holiday 
greetings, party or wedding invitations, thank-you let- 
ters, meeting announcements, business memos, or 
political messages. Giving each letter that "personal 
touch" is almost impossible— especially around the holi- 
day season when you've got so many other things to do. 

If you could only hire someone to keep track of all the 
important information that you cram into your little 
black book— someone to help you write personalized 
form letters. Such a person would have to sort, search, 
and update your records very quickly and at a moment's 
notice. And this person would also have to type each 
letter, inserting the appropriate "personalizing" details. 

Sounds like you'll have to hire a professional 
secretary— right? Not really. Your computer can com- 
pete with even the best secretary*— if you have the Elec- 
tronic Postman. When linked with Electronic 
Typewriter (published in Vol. 5. No. 5). Electronic 
Postman becomes a powerful "mail merger" data base, 
capable of quickly organizing, up-dating, and 
manipulating your entire address book. 

Individual Form 

Let's say you want to send all of your business 
associates a letter explaining a new policy that your 
company recently implemented. Use Electronic 
Typewriter to compose the form letter, and let Electronic 
Postman quickly insert specific names, addresses, and 
other individualizing information. There's no repetitive 
typing involved! The Postman prints each letter accord- 
ing to the format you specify, 
16 © Home Computer Magazine 1985 Volume 5, No, 6 



The program's main menu offers the following 6 

options: 

EDIT FILE 
SORT FILE 
SEARCH FILE 
LOAD/SAVE FILE 
PRINT FILE 
ELECTRIC MERGE 

Edit File 

This option allows you to create lists of up to 50 names 
and addresses or alter previously prepared lists. Each 
record consists of 7 different fields of information- 
Name, Address, City, State ZIP, Phone Number, Text, 
and Code (see Photo 1). A simple keypress moves your 
cursor to any of the 7 fields that you want to edit (see 
the Control Capsule for your machine). The first 5 fields 
are self-explanatory. You can use the Text field for ad- 
ditional information that you wish to include in the file, 
such as occupation, type of computer owned, birth date, 
spouse's name, or whether you'll be sending that per- 
son a Christmas card this year. See the Electric Merge 
section below for an explanation of the Code field. 

A small box in the lower-right corner of the editing 
screen displays a number corresponding to the record 
that you're currently working on. From this box, you 
can jump to any record within the file, by entering the 
appropriate number and pressing [RETURN]. 

Each time you press |RETURN) in the Edit File option, 
the cursor advances one field. If you are editing the very 
last field— Code— a [RETURN] advances the program to 
the next record. 

Sort File 

You can use this option to arrange all your records 
alphabetically or numerically (according to the 
characters' ASCII representations). Simply choose one 
of the 7 fields to use as criteria for sorting your records. 
A sort by State, for example, puts your records in 



Bug-Out Identifies Bugs 

Dear Sir: 

I own an Atari 800XL with a single disk 
drive, a tape recorder, and a very dotty matrix 
printer. 1 have previously owned four other 
computers, ail of which were ignored, for the 
most part, by the publishing industry, It was 
really nice to see the support for my machine 
at last. 

This reaction is tempered a little after a cou- 
ple weeks of (intermittently) typing programs 
from your magazine! The first thing I typed 
in was the Proofreader, and I must admit that 
it worked. The second thing I undertook was 
the Nano Processor and my experience was not 
so great. 

The first problem arose when I tried to enter 
line 920, a DATA item with a clear and un- 
mistakable Pounds-Sterling symbol. Atari X 
models have such a symbol; however, the use 
of it normally excludes the other graphic 
characters used in the NanoProcessor display. 
I eventually figured out that what you must 
have meant was a SHIFT + character used (by 
Atari mostly in other languages than BASIC) 
for mod division. 

The second problem was rather more of a 
bug, and took a while to figure out. The pro- 
gram checks the location 764 for last key 
pressed, and branches accordingly. At least, it 
ought to; it doesn't. The problem seems to be 
well illustrated by the segment from line 1500 
to 1580. The variable B contains the last-key- 
pressed identity from location 764; line 1520 
tries to match it against the ASCII value of the 
control-panel keys. But the Ataris use three in- 
terlocking character set designations; ASCII; 
Internal code, which is the sequential position 
of the character in the shape table; and 
Keyboard code, which bears little resemblance 
to the other two. Keyboard code is tied to the 
row-column position of the keys, and it is a 
member of this set which is stored at 764. Here's 
a one-liner for you to illustrate the point: 
1 FOR A= 1 TO 256: A = PEEK(764): 
?CHR$(A);" ";:NEXTA 

PLEASE type it EXACTLY as shown, The 
continuous reassignment of the counter variable 
value within the loop keeps the thing going 
forever, or until you have had enough (use 
BREAK to get out). Press any key, alone or 
with either or both of CONTROL and SHIFT 
keys. Try the Atari key (inverse toggle) and the 
CAPS, ESC, and RETURN keys. Try using 
each key with and then without the CONTROL. 
Try any key presses you like. CTRL- 1 which 
pauses all action and then unpauses it, and the 
BREAK key will not give unusual results. 

But back to the program bug. I thought of 
looking for the keys that would give the result, 
in effect reassigning the control panel in the 
game. Almost immediately after that, I thought 
of altering line 1 580 so that the correct connec- 
tion with ASCII would result. Both of these 
approaches had to be rejected because not all 
ASCII values represent valid keycodes. Not 
even all 6- or 7- bit numbers are valid. As a mat- 
ter of fact, it turns out that some of the values 
required for the program are not valid K-codes. 
The only workable solution I found was to 
rewrite the following two lines. 
1520 READ ZQ: IF B^ZQ THEN 1550 
1580 DATA 49,50,51,52,60,62,80,69,6, 
73,82,76,62 



I have not yet had a chance to play with the 
program, to see whether or not it is completely 
debugged. At least these fixes get it started 
running. 

I look forward to the next few issues of your 
magazine. I hope it lives up to the high prom- 
ises made by issue 5.5, apart from these details. 
Diane Hoffman 
Oshkosh, WI 54901 

We're glad to have such a knowledgeable 
Atari reader, Diane. Thanks for the comments. 
The Hrst bug you noted was due to an over- 
sight in our process for translating the program 
to our type-set listing format. The other bug 
seems to stem from an error you apparently 
made in typing in the program. Line 1460 does 
indeed PEEK location 764, but B does not con- 
tain the value from that location— it contains 
the AT ASCII returned from the GET #2, B 
statement, Thus, that aspect of the program 
works correctly as published. Thanks, though, 
for the excellent discussion of the various ways 
Atari machines represent key input, as well as 
for the neat little "one-liner," 

Word Pro From ProDOS To 3.3 

Dear Sir: 

I am having some problems with my Apple 
He. A few weeks ago, a friend of mine sent some 
documents he created with his word processor 
to me. The documents were on a ProDOS disk 
and were stored as text files. My problem is that 
most of the documents he sent to me that were 
stored as text files were stored under a sub- 
directory. My word processor can read text files 
when they are directly stored as text files, but 
not when they are stored under a sub-directory. 
My word processor translates the text files to 
files my word processor can understand. (The 
files are on a DOS 3.3 disk now because that 
is the only format my word processor can 
translate them from. I copied the files from the 
ProDOS disk. This procedure has always 
worked until now,) Do you know of any pro- 
gram or procedure that would allow me to store 
these text files directly onto the disk instead of 
under a sub-directory so I could print the files 
on my printer with my word processor? I need 
a solution really soon. 

Also, I have heard about a Z-RAM board 
by Applied Engineering that would allow you 
to add 256 or 51 2K of additional memory and 
a 2-80 microprocessor to the Apple lie. Their 
ad says that it comes with a RAM disk so pro- 
grams could run 20 times faster. It also said 
that you could run regular Apple software and 
CP/M software without unplugging the board. 
Do you think you could review this product? 
It sounds very interesting. 

Thank you very much for your help, 

Pete Sison 
San Diego, CA 92139 

In order to convert a file from ProDOS to 
DOSS J you need two disk drives and the Pro- 
DOS Convert utility from Apple. If you have 
these, the various sub-directories shouldn 7 give 
you any trouble in conversion— just specify the 
complete ProDOS pathname in the convert pro- 
gram, We are evaluating the Z-RAM card from 
Applied Engineering and will be reviewing it 
in a future issue. 



Hard-Driving Junior? 
Dear Sir: 

Like thousands of others, I thoroughly en- 
joy your magazine. In particular, I have used 
your techniques to successfully add a second 
floppy drive to my PCjr. Now I wonder about 
adding a hard drive. With the rapid de- 
escalation tn hard drive prices this would ap- 
pear to be a val uable next step. Any possibilities 
of your experts telling us how to do that? I am 
sure a number of us would benefit greatly. 
Warren T. Dent 
Indianapolis, IN 46260 

Warren, our experts are currently working 
on hard-disk drive solutions for the PCjr, so 
stay tuned to HCM for cost-effective means to 
expand your PCjr's capabilities. Also, if any- 
other readers desire additional Junior 
enhancements, please let us know so we can 
work toward giving you what you need. 

Terminal Tape Troubles 
Dear Sir: 

I recently purchased a modem through mail 
order for my Commodore 64. Somehow there 
was a mixup in my order and the company 1 
ordered from sent me the terminal software on 
disk instead of cassette tape as 1 requested. I 
contacted the company and they told me that 
the terminal software was unavailable on tape. 
When I borrowed a friend's disk drive to load 
the program and try' to transfer it to tape, I 
found that I could only access one line of the 
program which was a SYS command. Is there 
any way I can access the full terminal program 
and copy it to tape or will I be forced to pur- 
chase a disk drive to use my modem? 

Matthew Correll 
Grinnell, IA 50112 

Buying a disk drive is not a bad idea 
Matthew — especially now that the price on the 
Commodore 1541 is so low— but it is not the 
only answer. Several fine terminal programs 
come on tape and even cartridge. The popular 
VIP Terminal from Soft law is available on tape. 
The Ski Writer II cartridge from Prentice- Hall 
(Reviewed in HCM Vol. 5 No. 4) is both a word 
processor and terminal program. As for copy- 
ing and modifying the program you have now, 
don *t try. It may be copy protected, and the 
attempt may void its warranty. If what you have 
does not work with your current system, we sug- 
gest that you either buy a disk drive or return 
the package. 

Mini -Amnesia On Mini-Memory 
Dear Sir: 

The Mini-Memory module for my TI home 
computer wilt not accept assembly programs 
from tape, or BASIC programs from the com- 
puter. I assume the battery has died. 

Could you tell me if this can be remedied and 
if so, where do I send it? How much would it 
cost? How long would it take? Have I diag- 
nosed the problem correctly? 

Any information you could send me would 
be appreciated. 

John Wood 
Salem, OR 97306 

John, it's good that you should bring up this 
subject. There are a lot of Mini-Memory car 
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t ridges out there with weak or failing batteries. 
There 's a very good possibility that your Mini- 
Memory battery has finally gone to that great 
recharger in the sky. The symptoms you 
describe fit the dead-battery syndrome t though 
that doesn } t rule out the possibility that the con- 
nector could be dirty or the cartridge misaligned 
so that the pins on the card edge don 't fit cor- 
rectly when the cartridge is inserted into the 
system. Fortunately, there is help on the way. 
We are currently tracking down the least- 
expensive sources for the battery, and will tell 
you how to replace it in next issue's "Home 
Computer Tech Note" for TL 



Personal Accounts-Payable? 
Dear Sir: 

1 have an IBM PC and I am looking for a 
computer program that will do the following 
things. I was wondering if you would have this 
on any of the disks that are available through 
you, or if you might know where I could find it. 

It is to manage my personal bills. I would 
like to be able to enter the company name, com- 
pany address, or a code number for each com- 
pany, subtract the payment made and have the 
balance show. The next month I would like to 
be able to subject the payment again and have 
the account balance show. It would work like 
an accounts payable file. 

Thank you for your help. 

Florence M. Glenn 
Santa Ana, CA 92702 

Florence, so far we have not published a pro- 
gram that will totally "fill the bill" for you. 
We are, however, developing such a 
program — one that will not only allow the kind 
of file you suggest, but also provide great flex- 
ibility in customizing other kinds of 
alphanumeric/calculating data files. Look for 
this software soon in an upcoming issue. 



Looking For Artificial Intelligence 
Dear Sir: 

I will be a sophomore in high school next year 
and have acquired (through certain channels) 
a free hour each day which I spend working 
with Apple He computers. I also have a Com- 
modore 64 at home and I am planning to buy 
the new C-128 when it arrives on the market. 

My question is this: Do you know of any 
companies that specialize in literature and/or 
software on artificial intelligence program- 
ming? I intend to focus my future computer 
studies on this particular subject. 

Thank you. 

Philip G. Jones 
Slater, MO 65349 

Philip, your local library will probably have 
a few major books on Artificial Intelligence 
(AI), although such books are largely non- 
technical and are targeted for the popular 
market. Most famous among these is The Fifth 
Generation, by Feigenbaum and McCorduck, 
which talks about Japan's push forAl. Others 
include: Artificial Intelligence, byL. Stevens, 
The Thinking Computer, by B. Raphael t and 
Godel, Escher, Bach, by D. Hofstader. If you 
want technical information and news of the cur- 
rent state-of-the-art, a newsletter published out 



of Scott sdale t Arizona, called "AI Trends/' 
will fill your needs. You will find that most A I 
research these days, centers on "expert 
systems"— software that provides the kind of 
technical advice usually reserved for experts in 
a given field. For example, Hewlett-Packard 
employs an expert system on the assembly line 
to help diagnose defects in the structure of 
microchips. These programs use a combination 
of raw data bases and a "knowledge" base 
garnered by quizzing engineers on every con- 
ceivable "what-iF' situation. Some of these pro- 
fessional techniques have trickled down to the 
microcomputer level — with programs like Per- 
sonal Consultant for the TI-99/4A, Experlisp 
for the Macintosh, and the Knowledge 
Engineering System for the IBM PC. Human 
Edge Soft ware offers a few such ' 'decision mak- 
ing ' * programs for the Apple II family; but we 
don't know of any available for the C-64 or 
the C-128. (The C-128 should be compatible 
with A I software written for CP/M systems, 
however.) As these kinds of programs become 
more applicable to home use, we will certainly 
cover them in HCM. 



A Pound Sign For A Backslash 

Dear Sir: 

Imagine my surprise. I have never looked in 
your magazine, just at the cover. This time — 
Atari! 

Your magazine seems much more im- 
aginative than most of the others, especially in 
your programs and explanation sections. I see 
an excellent relationship growing. 

However, is it just because you are new to 
the Atari field? Your NanoProcessor program 
in Vol. 5, No. 5 has a bug that can't be just 
a typo. Line 920 has a data statement which 
includes an English pound sign! I can access 
this symbol on my 800XL with the International 
Character function, but it reverts to a simple 
CONTROL 'H' graphics symbol on LISTing 
or RUNning. What did you have in mind? 

Second, I can't get the program to work, I 
have CAREfully checked my listing but when 
I RUN the program I get an Input Statement 
Error (#8) on line 820. For some reason my 
computer will not accept the line 920 data 
statements. If I remove the offending 
statements (losing the switch pointer) the pro- 
gram runs for awhile until I enter the third line 
of the sample program where I get a String 
Length Error (#5) in line 1660. 

Last, but not least, Atari Bug-Out doesn't 
DO anything! It runs, it asks for output device, 
it says READING, but it doesn't access my 
cassette file. Is it supposed to operate my 
cassette recorder? Your instructions don't say! 

I know this letter looks hyper-critical, but it's 
not meant that way. I'm super impressed with 
your first Atari issue. I know it can only get 
better. 

Norm Palosky 
Alexandria, VA 22304 

Thanks for the input, Norm, and welcome 
aboard. For the answer to the first problem you 
mentioned, see "Bug-Out Identifies Bugs" 
(above). As for the Bug-Out program, other 
readers have experienced no difficulty; we can 
only conjecture that you have made a typing 
error. 



No Pro DOS-Compatibles 

Dear Sir: 

I have three different Apple II + compatible 
computers (from two different manufacturers) 
that I have been using heavily for over two 
years. I haven't had the slightest compatibility 
problem with loads of different software and 
with different operating systems, including 
CP/M and Pascal. But ProDOS doesn't work. 
None of the ProDOS diskettes that you have 
sent me works, Neither does one recently pur- 
chased program which is on a ProDOS diskette. 
The disks boot up displaying the title screen for 
the ProDOS release, then the computer locks 
up. The only key that the computer will res- 
pond to after that is RESET, which causes more 
problems, (Note: Two of the computers have 
16K RAMcards in slot 0, and the other has a 
128K Saturn board.) Is it necessary to purchase 
a ProDOS preboot diskette? Or is there some 
multiple-letter code to type in? Or has Apple 
figured out a way to defeat the "compatibles" 
with this latest operating system? 

If I'm out of luck with ProDOS, would it 
be possible for you to send me your Home 
Computer ON DISK software with DOS 3.3? 

Mike Rosa 
Peru, IN 46970 

Mike t on the second page of the Table of 
Contents in this issue, there are instructions for 
running ProDOS programs on Franklin 
machines. You don 7 say which brand of Apple- 
compatible you have, so we can J t guarantee this 
will work for you. In Vol. 5, No. 5 , a letter 
from Henry Curry provides another way of fix- 
ing a ProDOS disk for Franklin— by using a 
"Sector Editor." 



Expansion Of Coverage Hailed 

Dear Sir: 

This is the first time I have ever written to 
any magazine and I just wanted to say thanks. 
I am an avid Atari user and will help support 
anyone who supports Ataris. The first time I 
saw your magazine was several months ago on 
the newsstand. I was disappointed to see that 
you did not include Atari in your coverage. 

A couple of days ago, I was skimming 
through the magazine rack and saw issue 5.5 
with the small banner announcing Atari 
coverage. I immediately bought the issue. A day 
later I mailed my subscription. 

I have owned an Atari for about two years 
now, I started with the 400 and the 410 recorder, 
but now have an 800XL, disk drive, modem, 
and printer. 

Again, thanks for the expanded coverage. 

You can expect me to be a continued subscriber. 

Dennis E. Rees 

Willard, OH 44890 

Clad we are able to Fill your need, Dennis. 
We look forward to bringing Atari users a 
fresh — and badly needed — approach to home- 
computer usage. Hgu 
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In our last issue, we introduced you to TI Card 
Trix—SL program designed to help you create and 
edit an inventory of file cards containing though ts, 

book references, recipes, etc. Now we'd like you to meet 
Card Trix's helpful companion— TI Card Shuffler. This 
companion completes important filing functions faster 
than even the best secretary. And it lets you shuffle your 
cards between many different cross-referenced folders. 
The program begins by offering you two options: 

SEARCH CARDS 
EXIT PROGRAM 

Search Cards 

This option brings you to the heart of the program. 
You can begin indexing your cards from 4 different 
Card-Trix folders. When you select Search Cards for the 
first time, the program asks you to enter the search 
parameters you want to use to pull cards from folders. 
First, enter the item for which you are searching— any 
sequence of up to 28 characters. Then, specify the 
fleld(s) by which you want to search. You can search 
using the Index , Subject, and Text fields or any com- 
bination of the three fields. You must select at least one 
field, or the computer becomes irritated and beeps at 
you. Search Cards consists of these 4 options: 

GET A FOLDER 

TOSS A FOLDER 

SET SEARCH PARAMETERS 

RETURN TO MAIN MENU 

Get A Folder— When you select Get A Folder, the 
program asks for the name of the folder that you want 
to search through. After you enter the appropriate file 
name, the computer searches through the folder, noting 
all cards that meet the search parameter specifications. 
The computer then displays the number of cards, if any , 
that it finds. 

You can perform this indexing search with a max- 
imum of 4 folders in memory. If you want to search 
through a fifth folder, you must create space by discard- 
ing one of the folders with the Toss A Folder option. 

Toss A Folder— When you select this option, the 
computer displays a list of all the folders that are cur- 
rently in memory. To toss one of the displayed folders, 
enter the number that appears next to the unwanted 
folder. Don't worry: Tossing a folder does not erase it 
from the disk or cassette— only from memory. 



TI Card Shuffler 



by Randy Thompson 

HCM Staff 



Shuffle your file cards? Actually, 
computerized card sh uf fling can help you 
organize and expand your filing capacity. 



[Note: TI Card Shuffler is the second part of TI Card Trix, 
which appeared in HCM Vol. 5 No. 5J 



Set Search Parameters— You can change the 
search parameters with this option. If you can't find 
what you're looking for, for example, try changing the 
fields by which you are searching. 

Return To The Main Menu— When you return to 
the main menu with folders in memory, the menu ex- 
pands to offer you two more options: 

PRINT FOLDER INDEX 
SAVE INDEXED FOLDER 

Print Polder Index 

The folder index is a cross-reference listing of all the 
folders in memory. The printout contains the name of 
each folder in memory, the item used in the search for 
these folders, and numbers corresponding to the card(s) 
where the item was found. Let's say you printed a search 
for the word "DOG." Now, any time you need to find 
a card containing "DOG," simply refer to the indexed 
printout. You can also display a cross reference on- 
screen by selecting the Screen option. You can press 
the space bar to pause the screen display as it scrolls by. 

Save Indexed Folder 

Want a whole new folder instead of just an indexed 
printout? With this Save option you can shuffle cards 
from the 4 folders in memory into a new folder. 

When making a new folder, the program asks you for 
the disks or cassettes that hold the cards you want to 
shuffle. Now. insert the destination disk or cassette, and 
computer will save the indexed folder to the device with 
the file name you choose. {Note; Each folder holds no 
more than 25 cards; therefore, the program places only 
the first 25 cards it finds in the new foider.) 

Exit Program 

If you select this self-explanatory option and forget 
to make a printout or perform a search, don't worry. 
The program automatically asks you if you're sure you 
want to exit. At this point, you can either re-enter or 
exit Card Shuffler. 

HCM Glossary terms: cross-reference, Index, parameter. 

For your type-in listings, see HCM PROGRAM LISTINGS CONTENTS. 

HCM 
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Electronic 
Postman 



by Randy Thompson 

HCM Staff 



Neither rain nor snow nor the strictest of deadlines can keep you 
from writing individualized correspondence with this mail-merging program. 



If you're like many people today, you probably write 
personalized correspondence only when you have 
to. It's a time-consuming task! And it doesn't help 
when your list of addresses and phone numbers grows 
exponentially year after year. listing friends, relatives, 
business associates, congressmen, fellow club 
members, and more. 

Frustration usually sets in when you need to contact 
all or most of these people simultaneously for holiday 
greetings, party or wedding invitations, thank-you let- 
ters, meeting announcements, business memos, or 
political messages. Giving each letter that "personal 
touch" is almost impossible— especially around the holi- 
day season when you've got so many other things to do. 

If you could only hire someone to keep track of all the 
important information that you cram into your little 
black book— someone to help you write personalized 
form letters. Such a person would have to sort, search, 
and update your records very quickly and at a moment's 
notice. And this person would also have to type each 
letter, inserting the appropriate "personalizing" details. 

Sounds like you'll have to hire a professional 
secretary— right? Not really. Your computer can com- 
pete with even the best secretary— if you have the Elec- 
tronic Postman. When linked with Electronic 
Typewriter (published in Vol. 5, No. 5), Electronic 
Postman becomes a powerful "mail merger" data base, 
capable of quickly organizing, up-dating, and 
manipulating your entire address book. 

Individual Form 

Let's say you want to send all of your business 
associates a letter explaining a new policy that your 
company recently implemented. Use Electronic 
Typewriter to compose the form letter, and let Electronic 

Postman quickly insert specific names, addresses, and 
other individualizing information. There's no repetitive 
typing involved! The Postman prints each letter accord- 
ing to the format you specify. 
16 QHome Computer Magazine 1985 Volume 5, No, 6 



The program's main menu offers the following 6 
options: 

EDIT FILE 
SORT FILE 
SEARCH FILE 
LOAD/SAVE FILE 
PRINT FILE 
ELECTRIC MERGE 

Edit File 

This option allows you to create lists of up to 50 names 
and addresses or alter previously prepared lists. Each 
record consists of 7 different fields of information- 
Name, Address, City, State ZIP, Phone Number, Text, 
and Code (see Photo 1). A simple keypress moves your 
cursor to any of the 7 fields that you want to edit (see 
the Control Capsule for your machine). The first 5 fields 
are self-explanatory. You can use the Text field for ad- 
ditional information that you wish to include in the file, 
such as occupation t type of computer owned, birth date, 
spouses name, or whether you 11 be sending that per- 
son a Christmas card this year. See the Electric Merge 
section below for an explanation of the Code field. 

A small box in the lower-right corner of the editing 
screen displays a number corresponding to the record 
that you Ye currently working on. From this box, you 
can jump to any record within the file, by entering the 
appropriate number and pressing [RETURN], 

Each time you press [RETURN] in the Edit File option. 
the cursor advances one field. If you are editing the very 
last field— Code— a [RETURNj advances the program to 
the next record. 

Sort File 

You can use this option to arrange all your records 
alphabetically or numerically (according to the 
characters' ASCII representations). Simply choose one 
of the 7 fields to use as criteria for sorting your records. 
A sort by State, for example, puts your records in 
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PhOtO 1 

(From the IBM version) 

Each record contains 7 

fields of information 

that you can edit to keep 

your information 

up-to-date. 



alphabetical order according to the letters in each state's 
name. A sort by Phone Number places them in 
numerical order. To keep your records in order at all 
times, conduct a sort every time you add any records 
to your file. 

Search File 

This option helps you find any record in your file by 
searching through each record for a sequence of 
characters that you designate. Sound confusing? It's 
actually quite simple. When you enter the Search File 
option, the program asks you to enter the field you want 
to use as a search base. It then asks you to enter the 
sequence of characters to use in the search. For exam- 
ple, to find everyone in your file whose ZIP code is 
97401, simply select State ZIP and type in ''97401." 
Or if you remember only part of your barber's last 
name— you know it begins with "Mac"— don't page 
through all the records until you stumble across the 
right one. Perform a name search for "Mac," and let the 
computer do the work. 

Electronic Postman displays any record it finds, then 
offers the following three choices: You can edit the 
record, continue the search, or exit to the main menu. 
If Electronic Postman cannot find an item, it tells you 
so and brings you back to the main menu. 



Figure 2 
Sample Electronic Typewriter File 

Dear *F *, 

Thank you so very much for the wonderful 
wedding gift. Of all the presents we 
received, the *T * is one of the 
most thoughtful and useful. 

We are glad you could make it to the 
reception. The food and spirits couldn't 
have been better — especially the spirits. 

We hope the weather in *C * is nice 
this time of year. Honolulu was a little 
too warm for us, so we spent most of our 
honeymoon on the relaxing and romantic 
island of Maui. 

Be sure to call or write, and let us know 
if you move from *A * or 

change your phone number from *P * . 

Next time we are in *C *, we* 11 be 
sure to look you up. Thank you again for 
the *T *. 

Sincerely, 

Sigmund and Gertrude Green 





Figure 
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Codes For Electric Merge 


Code 




Function 


*N * 




Full name 


*p * 




First name 


+ |_ + 




Last name 


*A * 




Address 


*c * 




City 


*s * 




State ZIP code 


*p * 




Phone number 


*T * 




Text 



Load/Save Pile 

This option does exactly what its name implies. It lets 
you save and load files (each containing up to 50 
records). 

Print File 

To get a printout of your file, select this menu option. 
The program asks you to input the numbers 
corresponding to the first and last records you want 
printed. For example, if you enter " 1" as the first record 
number and "34*' as the last, the program prints records 
1 through 34. For alphabetized printouts, sort your files 
prior to printing. 

Electric Merge 

If you missed last issue's Electronic Typewriter pro- 
gram, you should seriously consider ordering it as a 
companion to the Electronic Postman. The Electric 
Merge option in the Postman integrates these two ' 'elec- 
tronic" programs, creating a very powerful writing tool. 

By inserting special codes in your Electronic 
Typewriter text, you can define locations to place 
specific pieces of Electronic Postman data, such as 
names, addresses, and phone numbers. (See Figure 1 
for a list of codes.) For example, if you need to send iden- 
tical letters to several different people, you can 



Figure 3 
Same Sample File After Electric Merge 

Dear Herbert, 

Thank you so very much for the wonderful 
wedding gift. Of all the presents we 
received, the toaster oven is one of the 
most thoughtful and useful. 

We are glad you could make it to the 
reception. The food and spirits couldn't 
have been better — especially the spirits. 

We hope the weather in Antelope is nice 
this time of year. Honolulu was a little 
too warm for us, so we spent most of our 
honeymoon on the relaxing and romantic 
island of Maui. 

Be sure to call or write, and let us know 
if you move from 3872 Roosevelt St. or 
change your phone number from 123-4567. 

Next time we are in Antelope, we'll be 
sure to look you up. Thank you again for 
the toaster oven. 

Sincerely, 

Sigmund and Gertrude Green 
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personalize each letter by inserting a name code into 
your text. When the Electric Merge encounters this 
code, the program replaces the code with the name you 
have specified from the Electronic Postman file. Each 
time you merge an Electronic Typewriter text file with 
an Electronic Postman record, the program outputs the 
result to the printer. (NOTE: All codes must be 
uppercase.) 

In order to make Electronic Typewriter as speedy as 
possible, we have included no word-wrap feature. 
Therefore, you must specify the number of characters 
you want to merge from the Postman record to the 
Typewriter text. For example, if the distance between 
the first and last asterisk in the code is 5 spaces, then 
that code can hold a maximum of 5 characters. When 
a piece of data, such as a first name, takes up less than 
the defined code length, the program adjusts the entire 
line of text, leaving no unnecessary spaces between 
words. However, if the data is longer than the maximum 
defined length, the program truncates the data to fit. 
Therefore, If you allot only 5 coding spaces for a 
7-character name, the program lops off the last two 
characters in the name. Also note that the program 
won't separate first and last names, unless you enter 
them into your record in one of the following formats: 
1) Redding, Herbert or 2) Herbert Redding. 

For an example of how to use Electric Merge codes 
within your Electronic Typewriter text, see Figure 2. 
This example employs 5 different codes: First Name, 
Address, City. Phone Number, and Text. Figure 3 shows 
the printout of the merged text using data from an Elec- 
tronic Postman record. 

Starting To Merge 

When you select the Electric Merge option from the 
main menu, the computer asks you for the name of the 
Electronic Typewriter text file you want merged. (This 
merge routine assumes that the Electronic Postman 
data is already in memory.) Electronic Postman has no 
option that enables you to load a template file, so if you 
want formatted printouts (centered, right-aligned, or in- 
dented lines), save your text file with a template. 

The program then asks if you want a Selective Merge, 
which allows you to choose specific records that you 
want merged With text from Electronic Typewriter, 
When you selectively merge, the program asks you to 
enter a password: the characters in the Code field of the 
record that you wish to merge. For example, if you enter 
"AIM" as your password, the Electric Merge routine 
merges only the records with A 1 A 1 in their Code fields. 

You can use question marks as "wild cards" in the 
merge routine. For example, if you enter "FL?P" as a 
password, the program merges records with similar 
codes, such as FLIP, FLOP, or FL2P-but not SLIP. A 
password containing only question marks is the same 
as no password. 

Once you've entered the appropriate password, the 
program begins merging your text and files. As each 
line of text is merged, the program sends it to the printer. 
It's a slow process, but it's much faster and far more 
accurate than manually typing the information. (Note 
that Electronic Postman does not merge records that 
have nothing entered into the Name field.) After the 
merging is complete, the program automatically returns 
to the main menu. Now. you're ready to begin another 
correspondence! 

HCM Glossary terms: ASCII, field, file, merge, record. 

For your type-in listings, see HCM PROGRAM LISTINGS CONTENTS. 

HCM 
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Edit Phone Number field 
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Erase current field 
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Insert blank into current field 


CONTROL D 


Delete character under cursor 


RETURN 
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Special Edition Winter '85/ '86 
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elcome. I'm Gary Kaplan, 
publisher of Home Computer 
Magazine, Music & Electron- 
ics Magazine, and the Cornucopia 
Catalog you are now reading. If you 
haven't already done so, may I sug- 
gest that you play the enclosed (bound-in) Soundsheet 
on an available stereo turntable system by carefully 
removing the recording at the perforations, and placing 
it on top of a regular LP record for stability. You're in 
for a pleasant surprise . . , 

Now that you've heard our musical extravaganza — 
and, 1 hope, enjoyed it— please take a tour of the 
catalog itself. We've included special informative "side 




bars" (shaded gold) on several of the pages to help you 
more fully understand some electronic music and audio 
concepts— information that is important for wise pro- 
duct selection. 

if you find the catalog and recording interesting, 1 
hope you will share them with your friends, relatives, 
and associates. And, if you know of someone who 
would be especially interested in our product offerings, 
drop us a line with their name and address. We'll be 
happy to mail them their own catalog. 

Happy Shopping 
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4. ORDER WITH COMPLETE 
PEACE OF MIND- 
KNOWING THAT EXPERT 
TECHNICAL SUPPORT IS AVAILABLE 

Cornucopia is part of the Emerald Valley 
family of companies (including Music & Elec- 
tronics Magazine, Home Computer 
Magazine, and World Class Audio). Before 
choosing a product for the Cornucopia 
Catalog, it is first carefully evaluated by pro- 
duct specialists at our Corporate Research 
Center, then put into daily use by our 
magazines' technical editors- All Cornucopia 
customers are welcome to direct their 
technical questions concerning the use of 
purchased products to our Technical Sup- 
port Representatives. Many of the products 
that we sell are also supported by editorial 
coverage in Music & Electronics Magazine. 
Additional support is provided by our Cor- 
porate Data Processing Center through 
targeted mailings of the Cornucopia Product 
Awareness Letter™. This personalized 
newsletter keeps individual customers 
abreast of newly released products which 
have the potential to interface well with pro- 
ducts they've already purchased. When you 
buy an item from the Cornucopia Catalog, 
we want to make absolutely sure you know 
how to use it properly, and continue to learn 
of new ways to fit it into evolving systems. 
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The Soundsheet takes you 
on an exciting Journey Into 
the world of electronically 
produced music. 



Guarantees Your 

Complete Satisfaction 

4 Big Ways 

1. ORDER RISK-FREE WITH A 
30-DAY RETURN PRIVILEGE 

We want you to try anything in this catalog 
risk-free. If not satisfied— for whatever 
reason—simply return the product to us 
prepaid and insured, in new unmarked con- 
dition with all its original parts, instructions, 
packing materials, and our original invoice 
within 30 days of when you receive it. You 
will receive a courteous refund. 

2. ORDER WITH COMPLETE 
PRICE-PROTECTION ASSURANCE 

Cornucopia strives to offer the finest quali- 
ty products at the best prices. You won't see 
the same item advertised for less elsewhere. 
In the unlikely event that you find any pro- 
duct you buy from us currently advertised, 
in stock, and selling for less than our catalog 
price, just send us a copy of the newspaper 
or magazine advertisement that appears 
during your 30-day risk-free trial, and a copy 
of your invoice. We'll issue you a courteous 
merchandise credit for the difference in 
price— or, at our option, we will refund the 
purchase price upon return of the merchan- 
dise, plus send you a free gift for your 
trouble. 

3. ORDER WITH CONFIDENCE 
IN PRODUCT DURABILITY 

We make sure every product is backed 
by a reputable manufacturer's service 
center. If you're having a problem geting 
satisfactory service— in or out of warranty- 
call our Customer Reiations Representa- 
tives. We'll assist you in getting your item 
fixed or replaced in a reasonable time. 
Your Satisfaction Is Our Business. 3 * 4 

The entire contents of this catalog Copyright © 1985, Emerald Valley Publishing Co. Cornucopia, Cornucopia Catalog, Cornucopia Product Awareness Letter, 
Home Computer Magazine, Music & Electronics, World Class Audio, Your Consumer P.A.L, and Your Satisfaction Is Our Business are all trademarks or service 
marks of Emerald Valley Publishing Co. Dolby Is a trademark of Dolby Laboratories Licensing Corporation; and dbx is a trademark of dbx Inc. 



—GIFT CERTIFICATES— 

Choosing the right gift for a musician 
or music lover is not an easy task. Why 
not make it easy by giving a Cornucopia 
Gift Certificate . . . 

They're available in any denomination 
of your choice. Both your name and the 
recipients are hand-written on a fine 
card stock. 

Surprise someone special, today! 




Each Utile of Music A Electronics Magazine explore* 
many fascinating subject areas Including Introductory 
music theory, audio and digital recording techniques, and 
the Interfacing of musical device* with home computers 
and home entertainment system*. 



The Mouse 

That 

Roars 




Not since two Steves in a garage 

showed the world a shiny new Apple 

has the potential for changing the world 

been so great! 



This was the amazing little keyboard syn- 
thesizer that convinced us a major revolu- 
tion was afoot Casio, the consumer elec- 
tronics giant, had quietly introduced 
another puny-looking musical keyboard- 
only this time, it turned out to be a profes- 
sional quality electronic instrument of 
mammoth sound capabilities, its tiny pro- 
portions, unpretentious parentage, and 
unbelievably low price— one step removed 
from the "toy keyboards" of the past— 
didn f t fool the pros for long. Once a few "big 
names" in the music world got their hands 
on this tittle box, Its powerful voice roared 
forth for all to hear . . . The secret couldn r t 
be contained. In the blink of an eye, the 
state-of-the-art in musical electronics had 
taken a quantum leap. The high-cost bar- 
rier blocking the entry into professional 
music creation and performance had been 
torn asunder. The music world would never 
be the same again . , , 

HIGH-TECH MADE PLAYER-FRIENDLY 

The CZ-10 1 is the first electronic keyboard 
to provide the crystal clean sounds of digital 
synthesis for this incredibly low price. Its 
sophisticated Phase Distortion sound 
generation circuitry is organized into the sim- 
ple block structure of an analog synthesizer 



The informative LCD window displays all wave- 
form and special affects parameters, and guides 
you In creating unique sounds of your own. 

with compare/recall capability— making it ex- 
tremely easy to create and modify complex 
waveforms. The CZ-101's 8*stage sound en- 
velope settings with 2 separate-but-mixable 
sound lines let you reproduce fat, multi- 
dimensional sounds with astonishing realism. 

Internal memory stores 2 banks of 16 
sounds each. The first bank is loaded with 
factory presets (in ROM) that cannot be over- 
written. The second bank is for user storage 
and retains its memory (battery-backed RAM) 
even when the keyboard's power switch is 
shut off. An optional plug-in RAM cartridge 
expands the on-board storage capacity to a 
total of 48 different sound patches. These 
battery-backed memory cartridges provide 
convenient off-line storage for user-created 
sound libraries that load instantly. 

You'll love the CZ-101"s "high-tech" panel, 
with bright LED indicators above each func- 
tion. A large LCD window display in the center 
of the front panel guides you through dozens 
of parameters for altering standard sounds 



Same Great Sounds With Standard-Sized Keys! 



The CZ-1000 comes packed 
with the same great features as 
a CZ-101, plus it sports 
standard-size keys with one of 
the best "feels" in the industry. 
Enjoy the CZ-1000's rich 
sounds, easy programmability, 
and MIDI capabilities — all iden- 
tical to those of the CZ-101. Unique dust- 
proof buttons, shoulder strap accomoda- 
tions, 12-pound weight and 3-way power 
supply make this an ideal value in a perform- 
ance keyboard that's easy to pack along 
with you. It uses any of the optional ac- 
cessories that are available for the CZ- 1 1 . 
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CZ-1000 Suggested Retail Price $699.00 



(S®G?G00!3COpIa PRICE 

CAT. NO. 1CCZ1QOQ $525 {$13.00 P&H) 



and building up your own special effects (with 
such features as pitch bend, vibrato, por- 
tamento . . . key transposition) and creating 
instruments of your own design. Interacting 
with this display has been made virtually 
"foolproof." 

4 FOR THE PRICE OF 1 

The surprises don't stop with the CZ-101's 
spectacular sounds. This impressive syn- 
thesizer has versatile MIDI (Musical Instru- 
ment Digital Interface) capabilities. MIDI IN 
and OUT jacks on the back allow your CZ-101 
to communicate with an exciting array of 
MIDI products that can greatly expand your 
instrument's capabilities. Such MIDI 
equipment— including other synthesizers for 
blending different sounds— can be added at 
any time, so your CZ-101 always remains a 
useful instrument in an expandable music 
creation and performance system. 

If you own a MIDI sequencer, a simple 
press of the CZ-101's MIDI button, 
transforms this 8-voice polyphonic syn- 
thesizer into a 4-voice, multi-timbrat ex- 
pander. In this mode, the CZ-101 allows you 
to perform 4 completely different 
monophontc instrument sounds at once. 
Create a whole band— program voice 1 to be 
your bass, voice 2 to be your guitar, voice 
3 to be strings, and voice 4 to be horns. Vir- 
tually any MIDI sequencer is compatible- 
see details in this catalog about the Casio 
SZ-1 MIDI Sequencer and MIDI software 
packages available for your home computer. 

FOR ACTIVE PLAYERS ON THE GO 

The CZ-101's small size, 7-pound weight, 
professional voice, and battery operation 
make this instrument "at home" in any en- 
vironment. The headphone jack and line-out 
(for easy hook-up to your stereo or optional 
powered speaker) provide great flexibility 
whether at home or on the road. (Head- 
phones allow the kids in the back seat to prac- 
tice QUIETLY on those long road trips.) 
Comes complete with batteries and audio 
connection cord. 

CZ-101 Suggested Retail Price S499.00 



(§©(r0QG0eopia Price 
CAT. NO. 1CCZ101 



$349 ($9.oo p&H) 



Optional AC Adaptor (AD-5), RAM Cartridge 
(RA3) and Powered Speakers (AS- 10 or AS-20) 
are found on page C-4. For Sennheiser MS 100 
headphones, see page C-13. 
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"Ploy It Again, 
RAM!" 

They laughed when I sat down at the keyboard 
to play my latest creation , . . 



, , . but when t pushed the PLAY button, the 
big professional sound of my personal elec- 
tronic orchestra performed my composi- 
tion with impeccable precision— turning 
their chuckles and smirks Into stares of 
amazement and admiration!* f 

YOUR ONE-FINGER'S BEST PAL 

Imagine a device capable of transforming a 
single synthesizer into an ensemble of dif- 
ferent instruments. Imagine a recording 
device that operates just like a simple tape 
recorder, but doesn't use any tape. Imagine 
a device capable of recording your perfor- 
mance at one tempo and later playing it back 
at another tempo— without altering the pitch 
of a single note! Imagine a device that plays 
back your performance in perfect rhythm, 
even though you recorded it very slowly- 
over brief sessions spanning several days- 
one finger at a time! This is the Casio SZ-1 
multitrack digital sequencer— a "smart" 
microprocessor storage device that 
transforms the CZ-101, CZ-1000, or other 
MIDI-compatable synthesizers into creative 



power tools and perfor- 
mance machines of in- 
credible versatility. 

Unlike other stand- 
alone sequencers in its 
price range, the SZ-1 isn't limited to two 
tracks with constant "bouncing" of material 
to always free up one track for recording. Its 
four separate tracks allow you to modify data 
on any track— at any stage of the compos- 
ing process. 

MANUAL & REAL-TIME RECORDING 

Enjoy the option of recording in either the 
manual mode (a maximum of 3,600 notes) 
or the real-time mode (1,800 note maximum). 
In the manual mode, the LCD window 
graphically depicts your music for easy 
editing. Erasing or inserting single notes is 
a breeze. Overdubbing additional MIDI- 
assignable tracks is faster than ever, thanks 
to the SZ-l's "instant reset" (return to the 
beginning) and built-in metronome. 

The SZ-1 is compatible with MIDI synthe- 
sizers with (or without) velocity-sensitive 




keyboards. Hook it up to a true performance 
keyboard like the Akai AX-80, and the SZ-1 
will capture your music's expressive 
dynamics! Or connect it to a MIDl-compatible 
drum machine and listen to your drums follow 
along in perfect "sync" with your synthesized 
tracks. A built-in cassette interface allows you 
to save your work to inexpensive cassette 
tape. Or, use an optional memory cartridge 
for instant loads. The battery powered SZ- 1 
comes with five "D" size batteries and two 
5-foot MIDI cables. 

SZ-1 Suggested Retail Price $399.00 



(SOPCQDaeopla Price 
CAT. NO. 1CSZ1 



$299 ($7.oo p&H) 



Optional AC adaptor AD-1 and Memory car- 
tridge RA-5 are shown below. 




(S<sX?D0GCCOpI« Price $69.95 
CAT. NO. 1CAS10 ($5.00 P&H) 






AD-1 AC Adaptor- 
Light-weight, econom- 
ical plug-in power for the 
SZ-1 MIDI Sequencer. 



SszE^copI a Price 

CAT. NO. 1CAD1 



$12.00 

($3.00 P&H) 



AS-10 Monitor— A powerful-yet- 
portable amplified speaker (5 watts) 
designed to use either batteries (6 D 
cells) or optional AD-5 AC adaptor. 
Suggested Retail Price $79,95 



AS-20 Monitor— An amplified speaker {5 watts) 
with a built-in graphic equalizer and chorus with 
rate/depth controls. Works with either batteries (6 
D cells) or optional AD-5 AC adaptor. 
Suggested Retail Price $129.60 




AD-5 AC Adaptor- 
Light-weight, plug-in 
power for the AS* 10 and 
AS-20 speakers, and the 
CZ-101 or CZ-1000 
synthesizer. 



■S®(7[OTCOpla Price 

CAT. NO. 1CAS20 



$99.95 

($5.00 P&H) 



Ccscraacopla Price 

CAT. NO. 1CADB 



$21.00 

($3.00 P&H) 





RA-3 RAM Cartridge— Battery- 
backed memory cartridge (for all CZ 
keyboards) stores your sound patch 
libraries for quick-access loading. 



^""xcopii 

CAT. NO, 1CRA3 



Prlce$39.00 

($3.00 P&H) 



VP-2 Volume pedal— Control your SP-1 Sustain pedal— Give your 

CZ-5000's volume using your foot as CZ-5000 that piano-like feel with this 

you play. Achieve crescendo and quality sustain pedal, 
decrescendos effortlessly. 



£©f7CDKJCOpla Price $49.00 

CAT. NO. 1CVP2 ($4.00 P&H) 



(SoCPGQGOCOpfa Price $19.00 
CAT. NO. 1CSP1 ($4.00 P&H) 




RA-5 RAM Cartridge— Battery- 
backed memory cartridge for SZ-1 
sequence storage. 
Suggested Retail Price $89.95 



^tzv xcopia Prlce$79.95 



CAT. NO. 1CRA5 



($3.00 P&H) 
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Ram bo's 
Real-Time Bond 




There's some hostile territory out there. A jungle of 

connection cords to come undone, booby-traps lying in wait 

for your special effects and splitter boxes, and an 

unexpected sync ambush for your keyboard arsenal . . . 



When you pack up your gear for a crucial 
musical session, your mission's success de- 
mands peak performance from your equip- 
ment That's why the CZ-5000 is fast becom- 
ing the choice of unstoppable pros determined 
to reach their musical goafs no matter what 
the odds . . . 

When Casio introduced the CZ-101, the pro- 
duct's price/performance ratio leapfrogged an 
entire generation of competitive products and 
established itself as a major technological mile- 
stone. (See our write up on page C-3.) Shortly 
thereafter, the SZ-1 MIDI sequencer was born 
(see page C-4). It was the perfect companion 
to the 101— matching it in price/performance 
and ease of use. After this one-two combination, 
Casio then delivered the knock-out punch with 
the CZ-5000, an integrated instrument that com- 
bined twice the power of its predecessors at the 
best price/performance ratio yet. 

DOUBLE THE POWER— PLUS 

There's no arguing the fact that this is a 
stunning-looking machine. It draws oohs and 
aahs from all who see it . . . 

At first glance, it appears that the CZ-5000 
is simply two CZ- 1000s and two SZ-ls— all within 
a full-size (5-octave) keyboard. But first glances 
are often deceptive. If that were all the differ- 
ence between the units, it would still be more 
than enough to justify the difference in price: 
The CZ-5000 is simply a marvelous value. 

When you use this keyboard in actual music 
production, however, you start to realize the 
subtle-yet-significant differences: 

The CZ-5000 has the same standard-size keys 
as the CZ-1000 (the 101's big brother), but it 
boasts a 61-key, 5-octave— -rather than a 49-key, 
4-octave— range. Then there's the 16 big voices 
of the keyboard available in polyphonic mode— 
for fat, 8-part chords that sustain while hitting 
follow-ups (in real-time performance). Used as 
a MIDI expander, it can sound 8 different 
instruments — or any simultaneous combination 
of polyphonic sound(s) and monophonic sounds 
totaling 8 voices. For example, you can have a 
3-note piano chord sounding while playing 5 
other 1-note voices such as bass, brass, flute, 
organ, and hand-clap. 

The special enhancements don't stop here. 
Your CZ-5000 also provides a keyboard-split 



capability with independent volume level 
settings— allowing you to, for example, play a 
synth bass with your left hand, and vibes with 
your right. Also, the standard CZ-series tone mix 
capability is a little more sophisticated — allowing 
independent level settings without having to go 
in and modify the actual patches. You can even 
program the built-in metronome to simulate dif- 
ferent time signatures. Add in a stereo chorus 
capability, modulation wheel, stereo line-out 
jacks, and you have the makings of some very 
impressive special effects! 
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The built-in B -track MIDI sequencer with a 6800-noto capacity 
in manual mode and 3400-notM In realtime recording It at ea*y 
to u»t at a cassette tape recorder. 

In addition to the built-in AC power supply, the 
unit has a built-in cassette tape interface for stor- 
ing both sound patch data and sequencer data 
on standard cassette tapes, allowing you to build 
up economical libraries. The 5000 will also ac- 
cept RA-3 RAM cartridges for storage of 16 
sound patches in each. 

All in all, this 26-pound handsome keyboard 
synthesizer has an impressive arsenal of 
features at an equally impressive price. When 
you attack any mission with this explosive per- 
formance package, you are fully armed and 
equipped to settle any score . . . 

CZ-5000 Suggested Retail Price $1199.00 



(£<®mODCOpla Price 
CAT. NO. 1CCZ5O00 



$849 ($21.00 P&H) 



Optional RAM Cartridge (RA-3), Casio powered 
speakers, VP-2 volume pedal, SP-1 sustain pedal, 
are on shown on page C-4. See page C-12 for 
Fostex powered monitors. ForSennheiser MS 100 
stereo headphones, see page C-13. 



WE'RE TALKIN' SYNTHESIZERS! 

Synthesis is the combining of separate 
elements into a whole . A synthesizer is an elec- 
tronic musical instrument used to create (pro- 
gram) tone colors, or timbres, from basic 
building blocks of sound (wa ve forms). Syn- 
thesizers typically come with factory-installed 
sounds {presets) stored in memory. You can 
either temporarily or permanently modify the 
presets, or concoct new sounds from scratch, 
using the resources of the instrument. The syn- 
thesizer's memory may be dumped onto a 
RAM cartridge or or standard cassette tape 
allowing you to save your sounds for future 
use. Over time, you can create a library of hun- 
dreds of these sounds which can be reloaded 
in groups of voices (banks). 

Polyphonic synthesizers (capable of playing 
two or more notes together) are categorized 
by how many notes may sound at the same 
time, (A 6-^o/te synthesizer, for example, 
allows you to play up to 6 notes simultaneous- 
ly.) A multi-timbral instrument is capable of 
producing more than one tone color at a time. 
For example, a multi-timbral synth could sound 
a flute melody over a string-bass rhythm pat- 
tern. This effect is limited only by the number 
of voices available on a particular instrument. 

Certain synthesizers have a stereo output. 
On this type of instrument, the voices are 
distributed from left to right across the stereo 
field image in a variety of ways, depending on 
the design of the synthesizer. Some stereo in- 
struments offer chorusing. This electronic ef- 
fect enhances the sound by gently wavering the 
pitch and rolling the sound back and forth be- 
tween a pair of speakers. 

THE PIANO'S STEPCHILD 

Typically, a synthesizer is equipped with a 
piano-like keyboard that permits you to play 
timbres as discrete pitches. Once electronic 
sounds are in pitch form, you may easily 
organize them into melody and harmony— the 
building blocks of music 

Some keyboards are velocity sensitive: the 
force with which you strike the keys affects 
the volume and tone of each note. Certain 
keyboards also offer after touch: when you 
continue to press a key after playing an initial 
note, the synthesizer measures this pressure 
and uses it to trigger volume, modulation, or 
filter circuits. This feature gives you expressive 
fingertip control over sound, by allowing you 
to add vibrato to a note, or control its volume 
and tone after the initial keystroke has 
occurred. 

ANALOG VS. DIGITAL 

A synthesizer has the potential to produce 
a virtually limitless variety of timbres; it 
therefore has no particular sound of its own. 
Or does it? 

A synthesizer is a sonic chameleon. Yet, like 
an acoustic instrument, each type of syn- 
thesizer has a characteristic sound quality. By 
and large, the method used to generate the raw 
waveforms employed in synthesis determines 
this overall sound. Analog synthesizers use con- 
tinually varying voltages to control oscillators 
in a one-to-one (analog) correspondence to the 
audio signal These instruments then filter and 
modulate the results to create new sounds. Re- 
cent developments in computer technology 
have now brought us digital synthesizers, which 
store sound as numbers. Analog synths are 
known for their warm, lush, buzzy timbres. 
Digital synths are recognized for their clear, 
bright, defined sounds. Some synthesizers com- 
bine elements of both types by placing voltage- 
controlled oscillators under the command of 
a micro-processor. 

WHEN IS A SYNTH NOT A SYNTH? 

A sound sampler isn't limited to the overall 
sound quality and combined circuitry built into 
a particular model of synthesizer. Samplers 
record "real sounds'* and store them in digital 
form. These sounds are accessed by a key- 
board— allowing you to play harp or guitar or 
even barking dogs from the same instrument. 
Strictly speaking, these instruments aren"t 
synthesizers— yet they are playing an increas- 
ingly important role in electronically produced 
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A G-Note Gets The AX 




For real-time recording and performing, 
a musician requires a keyboard that cap- 
tures all the music's subtle dynamics cor- 
responding to the velocity with which one 
strikes the key. These expressive dynamics 
are then transmitted to other synthesizers 
and/or stored (in a sequencer's memory) 
together with other standard MIDI data, 

VISUAL EDITING & MORE 

But affordable touch-sensitivity is not all 
the Akai AX-80 has to offer: Analog syn- 
thesizers like this used to have many levers 
to control the oscillators and other com- 
ponents. Like many other manufacturers, 



Akai put on a digital-controller "front-end"— 
but, unlike others, didn't depend on the per- 
vasive LCD to display read-outs of the sound 
parameters. Instead, the AX-SO sports five 
attractive Fluorescent Display (FD) units on 
the front panel. These enable visual check- 
ing and monitoring of the sounds being 
generated— effectively reducing the sound 
programming time. 

The AX-80 is a 8-votce polyphonic syn- 
thesizer with two main oscillators and a sub- 
oscillator for a rich sound. In addition to the 
32 preset sounds, this 34-pound unit con- 
tains 2 memory banks for user storage of up 
to 64 additional sounds. A standard cassette 



An 8-voice synthesizer with 
touch-sensitive keyboard 
for under $1000? 

"No Way!"-they said, 
it took a sharp Akai AX 

to slash the price barrier . * , 



interface allows off-line storage of sound data 
on tape. Other back-panel jacks provide for 
audio out (mono), headphones, sustain and 
program-stepping pedals, and MIDI 
IN/OUT/THRU jacks. 
AX-SO Suggested Retail Price $995.00 



(SotfOtBieopia Price 

CAT. NO. 1AAX80F $795 ($55.00 P&H)* 



Optional Roland DP-2 accessory (below) will 
work as either a sustain or program-stepping 
pedal for the AX-80. For MIDI cables and audio 
output cable, see page C-12. Sennheiser 
MS-100 stereo headphones are on page C-13. 
For powered speakers, see pages C-4 and C12. 

* Dimensions necessitate shipping via air express. 




AN UNEXPECTED SPARKLE 

The JX-8P is both a performer's dream 
machine and a sound paradox. Because it 
is both velocity and pressure sensitive, 
even the slightest change in touch is 
reflected in the sound. Oscillators' pitch, 
mix balance, filter cut-off frequency, and 
amplification level are directly affected by 
the velocity of key strikes. After-touch 
pressure on the keys control the vibrato 
depth, the brilliance, and the volume. 

Two oscillators and two envelope gen- 
erators produce the 6 polyphonic voices. 
As an analog synthesizer with extensive 
modulation controls, theJX-SPIs expected 
to produce strong bass color . . . but when 
it also puts out bright, sparkty bell colors 
at the top end— like an FM digital 
synth— musicians shake their heads 
in utter amazement. 



THE GIG MACHINE 

The JX-8P offers 64 preset 
patches— including extremely thick 
string sounds, cross-modulated 
metallic sounds, and a variety of 
special effect sounds. There's on- 
board storage for another 32 user 
patches, plus an optional cartridge 
holding 32 additional programmable 
patches. An on-stage performer can 
thus instantly recall 128 patches! 

This 25-pound , 5-octave performer 
also allows you to name patches and 
store the names in memory. When re- 
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Sir 
Roland— 
The Rood Warrior 

When you need a solid MIDI performer for the road, you 
cant afford to go unprepared. Pros pack a Roland. 
JX-8P is its name— real-time control, its fame . . . 



called, the fluorescent display spells out the 
patch name— plus parameter names during 
editing. You can easily select desired patches 
and parameters even on a dark stage! Throw 
in a Patch Chain function for memory recall 
of up to 8 performance-ordered special ef- 
fects, and you wind up with a bone-fide Road 
Warrior . . . one that brings out the best in 
all connected MIDI instruments. 



Back-panel jacks provide stereo output, 
MIDI IN/OUT/THRU, and inputs for optional 
sustain pedal and PG*800 programmer con- 
sole. Comes with two 1/4-inch to RCA phone 
cords with 1/4-inch plug adaptors. 
JX-8P Suggested Retail Price $1695.00 



S©f?IKjQCCOpia Price 

CAT, NO, 1RJX8P $1249 ($1900 P&H) 



M-16C Cartridge 




(^©Pmmcopia Price 
CAT, NO. 1RM1GC 



$47.95 ($3,oo p&H) 



AB-2 Carrying Case 



SeraoQCapia Price 

CAT. NO. 1RAB2 



$100 ($8.00 P&H) 



DP-2 Pedal 



(£<°XmWCOpia Price 
CAT. NO, IRDP2 



$16 ($3.00 P&H) 



PG-800 Suggested Retail Price $295.00 



The PG-SOO It a programmer's panel designed exclusively for use 
with the JX-SP. All synthesizer parameters can be controlled by the 
PG-800's sliding controls — greatly simplifying and speeding up the 
creation of new patches, and modifying presets. It neatly fits on top 
of the JX-8P and is held in place by a magnetic seal. Comes with its 
own carrying case and connection cable. 



CSdXTGDGOCOpia Price 
CAT, NO. 1RPG800 



$225 ($6.00 P&H) 



Optional Sennheiser MS- 1 00 headphones are 
on page C-13. For monitors, speakers and MIDI 
cables, see pages C-4 and C-12. 



Ringo In A Dox 



iTR-TOT* 



I 




mmmit 



Even if you don't have a ticket to ride, you'll 
be hard-pressed to snare a more versatile drummer . . . 




Is It live, or is it a drum machine? With 
Roland's TR-707 Rhythm Composer, the 
drums and percussions sounds not only 
sound real, they are real— digital record- 
ings of real instruments: 2 Bass Drums; 2 
Snare Drums; Rim Shot; Low, Mid t and High 
Toms; Open and Closed Hi-Hats; Ride and 
Crash Cymbals; Cow Beit, Hand Clap, and 
Tambourine. Couple this with the 
machine's dual accentabiilty f variable tem- 
po, stereo output shuffle and flam capabili- 
ty, 1 individual outputs— allowing tailored 
processing— plus extensive full MIDI and 
sync-to-tape features, and you have a 
world-class drummer that's hard— or is it 
easy?— to beat at anywhere near this price. 

WHERE'S THE BEAT? 

The Rhythm Composer's large LCD win- 
dow provides an unusual feature in drum 
machines at any price: the ability to see your 
rhythm notes graphically displayed. The win- 



dow depicts the pattern in use, tem- 
po in beats-per-minute, MIDI channel 
operating mode, and the rhythms that 
each individual instrument plays. This 
means that you have full control of 
each measure, with the ability to write 
or edit down to the 32nd note! This 
comprehensive display allows even 
mm beginners to easily program rhythm 
patterns that would be difficult to do 
on other machines. 

With The Rhythm Composer's 998- 
measure memory capacity, you can write 
complete rhythm tracks (or entire songs), by 
stringing together up to 64 individual pat- 
terns either in "real time" or step-by-step. 
And— unlike other machines— you can 
switch between real and step modes even 
while programming! You can also use the 
Flam, Shuffle, and Accent functions to give 
your recordings that "live" feeling. 

The TR-707 looks innocent enough, but 
its bite is actually bigger than its bark! The 
compact Rhythm Composer weighs a mere 
3.3 pounds but packs a punch that matches 
even the biggest drumset sounds. The unit 
is completely MIDI-capatible and allows any 
velocity-sensitive MIDI keyboard to control 
its sound dynamics. This means that ex- 
pressive drum playing can be performed 
directly from a keyboard! And, a tape-sync 
function allows the TR-707 to synchronize 



to a multi-track recorder, for building up more 
complex tracks. 

Rhythm programs save to a battery-backed 
memory; and the unit's built-in tape interface 
provides data storage on standard cassette 
tape. Or, you can off-load to an optional 
memory cartridge (M-64C) with twice (two 
banks) the internal storage of the TR-707. 
When plugged into the machine, the car- 
tridge allows free selection between all three 
memory banks — offering plenty of rhythm 
variations for both recording and performing. 

TR-707 Suggested Retail Price $595.00 



©sffGDOoeopIa 

CAT. NO. 1RTR707 



Price 



$449 ($9.00 P&H) 



Options: 

M-64C Memory Cartridge 

Suggested Retail Price $89.95 



(StSFmODCOpia Price 

CAT. NO. 1RM64C 



$79 ($3.00 P&H) 



DP-2 Start/Stop Pedal Switch 



(S(SX?IH]Gi]COpia Price 
CAT. NO. 1RDP2 



$16 ($3.00 P&H) 



Optional MIDI cables are shown on page C*12. 
For the Sennheiser MS 100 stereo headphones, 
see page C-13. 



Sonic 
Alchemy 

Magically transform 

any sound you record into an 
instrument you can play! 
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Imagine being able to give your MIDI 
keyboard virtually any new sound you 
hear — even your own voice— and be able 
to do it in a few seconds, with no messy 
waveforms to fiddle with . . . Envy those 
Eiectro-plasmodic space warp sounds your 
friend gets on his new, holographic laser- 
drive super synth? Don't envy 'em— just 
sample 'em! Need a realistic acoustic 
guitar or piano sound, but don't have the 
big bucks it takes to equip yourself with 
what the big boys use? Just sample the real 
sounds yourself, and play them back with 
your own modest keyboard. 

What does it cost to have all this sonic ver- 
satility at your fingertips? Fortunately, Akai 
has once again made state-of-the-art 
technology extremely affordable— well within 
the range of assembling a serious-yet- 
moderateiy priced home music studio. 



The Akai S612 Digital Sampler uses a 
12-bit sampling circuit for a maximum sampl- 
ing rate of 32K Hz for 1 second, and 4K Hz 
minimum rate for up to 8 seconds. This pro- 
vides the flexbililty to meet most needs. 

SPECIAL EFFECT MAGIC 

The S612 features a variety of built-in 
editing functions that will fine-tune— or ar- 
tistically distort — your sound samples. You 
can sample any portion of a sound, or use 
the looping and alternating functions to 
repeat or alternate sounds; even overdub- 
bing and backwards playback is as simple as 
a keypress. 

When the S612 is connected to a MIDI 
keyboard, you can play back 6-voice sounds 
over a 5-octave range, Akai's companion 
MD-280 Disk Drive uses 2.8-inch disks to 
store your samples (one per side). A built-in 



interface on the S612 also allows sample 
storage dumps to a Commodore Datasette 
recorder. 

S612 Suggested Retail Price $999.95 



<S®[?[70Q£]eopia Price 

CAT. NO. 1AS612 $749 ($13.50 P&H) 



MD-280 Suggested Retail Price $299.95 



(SGXTDDEJCOpla Price 

CAT. NO. 1AMD2S0 $249 ($8.50 P&H) 



10-pack of 2.8-inch disks 
Suggested Retail Price $49.95 



(3®ffDD09C©pia Price 

CAT. NO. 1A0L100 $42.95 ($3.50 P&H) 



NOTE: See page C- 12 for the recommended Fostex 
microphone for sampling. 
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Bring Your Computer Into The Act 



MIDI SEQUENCERS 

The MIDI (Musical Instrument Digital In- 
terface) sequencer has become the heart 
of many electronic musical instrument 
setups. It has three purposes: I ) to store 
MIDI performance data as it's played on 
your MIDI keyboard, 2) to make editing 
this performance a breeze, 3) to play back 
your performance (in its original or altered 
form) by sending MIDI data back to your 
synthesizer. In short, it's a digital recorder 
that allows you to "fix" notes before it 
plays them back! 

Editing features are what make MIDI se- 
quencers so valuable to synthesizer 
players. Imagine being able to change 
notes, rhythms, synthesizer patch settings, 
tempos, transposition, and the order of 
phrases in your compositions— all after 
you perform them. The MIDI sequencer 
can do all this with the push of a button. 

A FORK IN THE ROAD 

MIDI sequencers are available in two 
designs: dedicated and software-based 
Both systems are capable of performing 
the same basic tasks. But each also has its 
own advantages— the choice is yours. 

DEDICATED-"THE BOX" 

Dedicated MIDI sequencers are stand- 
alone boxes that connect to your MIDI 
keyboard via two MIDI cables. One cable 
carries performance data from your synth 
to the sequencer, while the other cable 
carries MIDI data from the sequencer to 
your keyboard, Dedicated sequencers 
have digital memory, just like home com- 
puters. But they can't be used for anything 
except sequencing— sorry, no checkbook 
balancing with these units! 

Dedicated units are streamlined to do 
their job efficiently. Their controls usual- 
ly resemble those on tape recorders. 
These units are also generally compact and 
portable, making interface to your 
keyboards a snap. 

Most dedicated sequencers allow you to 
store sequence data on cassette tape. 
Some allow storage on optional memory 
cartridges, and other more expensive units 
have built-in disk drives for storage on 
disks. 

SOFTWARE-BASED 

The software-based sequencer is de- 
signed to take advantage of the power of 
your home computer, while performing 
the same functions of dedicated sequenc- 
ers. These sequencers require a specific 
amount of computer memory, a monitor, 
a disk drive, and a MIDI interface that is 
compatible with your particular system. 

This cost-effective sequencer design of* 
fers many advantages over dedicated 
units— especially if you already own a com- 
puter. The advantages include visual display 
of recorded tracks, visually assisted editing, 
and disk storage of sequences, And 
because the sequencer functions 
themselves reside on disk, these programs 
are periodically updated by the 
manufacturer. 

THE BEST! 

Your particular needs wjll determine 
whether you purchase a dedicated se- 
quencer or a software -based system. If it's 
portability and simplicity you want, ex- 
plore the dedicated models. If you already 
own a home computer and anticipate a 
continually growing MIDI setup, took at 
the software-based systems. 

Today the electronic music market is 
flooded with a myriad of sequencer 
systems. But the software- based programs 
on this page, and the dedicated model on 
page C-4 represent the finest value on the 
market today! 
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All MIDI software packages require 
a compatible MIDI hardware interface. 
These interfaces are either included or 
are available separately as noted. 



Home Computers Make Tracks, Too! 




Apple II + , lie: Passport's MIDi 4 + (4 
tracks) or MIDI 8 + {8 tracks) software 
packages require Passport interface 
MH-01A or MH-02A (which includes 
tape sync). These packages give you 
unlimited overdubbing, punch in/out for 
easy editing, single-step playback, fast 
forward/rewind, auto-correct to 32nd- 
note triplets, real-time tempo change, 
and drum sync. Single-step editing 

CAT. NO. 1P4A MIDI 4+ 



makes for easy selection of where 

changes are to begin. 

Software Includes: one 5-1/4" disk and 

complete instruction manual. 

Interface Includes: two MIDI cables and 

manual. 

Requirements: 48K, disk drive, monitor 

Recommended accessory: RCA to RCA 

cable for tape sync with MH-02 A (page C- 1 2). 

Suggested Retail Price <£©(FtfB3COpla Price 

$129.95 $109 ($4.00 P&H) 



CAT. NO. IPSA 


MIDI 6 + 


$169.95 


$149 ($4.00 P&H) 


CAT. NO. 1PMH01A 


MH-01A Interface 


$149.95 


$129 ($4.00 PAH) 


CAT. NO. 1PMH02A 


MH-02A Interface 

(w/tape-sync feature) 


$199.95 


$169 ($4.00 P&H) 



Commodore-64: The MH-01C inter* 
face plugs into the G-64 user port and 
works with either of Passport's MIDI 
4+ (4 tracks) or MIDI 8+ {8 tracks) 
software packages. The software 
features a clearly designed display, 
unlimited overdubbing, punch in/out for 
easy editing, single-step playback, fast 
forward/rewind, auto-correct to 32nd* 
note triplets, real-time tempo change, 

CAT, NO. 1P4C MIDI 4 + 



CAT. NO. 1P8C 



MIDI 8 + 



and drum sync. Single-step playback 
allows you to step through 24 incre- 
ments of each beat to pinpoint 
changes. 

Requirements: disk drive, monitor. 
Software Includes: one 5-1/4" disk and 
complete instruction manual. 
MH-01C interface Includes: three MIDI con- 
nections and manual + 2 MIDI cables. 
Suggested Retail Price ©SffGOGGCOpIa Price 
$99.95 $89 ($4.00 P&H) 

$149,95 $129 (S4.00 P&H) 




CAT. NO. 1PMH01C MH-01C Interface 



$129.95 



$109 {$4,00 P&H) 




Atari: Hybrid Arts MIDITRACK Jl se- 
quencer gives you 16 MIDI recording 
tracks, punch in/out capability, step 
editing, rhythmic auto-correct, track 
naming, and the most complete sync 
options on the market. This package 
comes complete with the required 



CAT. NO. 1HA2 



MIDITRACK II 
(with MIDIMATE) 



MIDIMATE interface and two MIDI 

cables. 

Requirements: Atari 800, 800XL, 130XE, 

400, or 1200XL (48K min). Atari 810 or 

1050 disk drive, and monitor. 

Package includes: 1- 5 1/4" disk, manual. 

interface and 2 MIDI cables. 

Suggested Retail Price S©£7GQGDC*>plJI Price 

$349.00 $279 ($6.00 P&H) 



Macintosh: Opcode's MIDIMAC se- 
quencer & interface take full advantage 
of Macintosh graphics capabilities. This 
sequencer mimics the controls of a 
standard tape recorder on screen! It 
records up to 24,000 notes, on 26 se- 
quences with 10 tracks each. You can 



CAT. NO. 10S1 



MIDIMAC Interface 



even play back 1 6 sequences at once! 
Requirements: Macintosh (512K). 
Software Includes; 1-3 1/2" disk, manual 
Interface Includes: hardware module which 
plugs into the modem or printer port. 
Recommended Accessories: 2 MIDI cables 
(page C-12). 

Suggested Retail Price (SdXTTOODCOpfa Price 
$125.00 $109 ($4.00 P&H) 



CAT. NO. 10S2 



MIDIMAC Sequencer 



$150.00 



$129 ($4.00 P&H) 





IBM PC: The Roland MIF-IPC inter- 
face kit and MPU-401 (MIDI process- 
ing unit) along with Cherry Lane's Tex- 
ture turn your IBM PC into an 8*track 
sequencer. Texture uses a unique 
"modular recording" process to com- 
bine up to 64 "patterns" into com- 
pleted compositions— allowing you to 
compose your tune in musical phrases 

CAT. NO. 1CLT1 Texture 



and let the program link them together. 
Requirements: 128K, disk drive, monitor. 
Software Includes: 5 1/4" disk and manual. 
Interface Includes: MIF-IPC interface Kit + 
cable to the MPU-401. MPU-401 comes with 
a manual. 

Recommended accessory: 2 MIDI cables for 
MPU-401 (page C- 12). 

Suggested Retail Price -I" "COpia Price 
$199.00 $169 ($4.00 P&H) 



CAT. NO. 1RM1F1PC MIF-IPC Int. Kit 



$100.00 



CAT. NO, 1RMPU401 MPU-401 Proc. Unit 



$200.00 



$89 ($ 4. 00 P&H} 

$T59 ($5.oo p&h) 



TI-99/4A: The TEX-SEQ interface 
cable and software from World Class 
Software allows for note-by-note entry 
of musical compositions, and playback 
on any MIDI synthesizer. Software pro- 
vides 4 play tracks and supports 
several different time signatures. Files 



may be saved to disk for easy storage 
and recall. 

Requirements: Extended Basic, 32K 
memory expansion, disk drive, and monitor. 
Package Includes: MIDI interface cable, one 
5-1/4" disk, and manual. 



CAT. NO. 1WCT1 TEX-SEQ 



(SeXTDDGOCOpfa Price 

$49.95 ($4.00 p&h) 




Studio To Go 

For a take-out order that's musically nutritious, 
high in unsulfured creativity, low in weight 
and that wont upset your budget . . . 



Look no farther for a full-featured mini 
recording studio with maxl capabilities— 
as easy to use on the go, as it is at home! 
The Fostex X-15 puts multi-track recording 
technology at your fingertips. With it, you 
can create great sounding demo tapes- 
just like the pros do— with built-in features 
that let your creativity run wild . , . 

The X-15 is a complete, ultra-compact 
4-track cassette mixer/recorder system. It 
allows you to build your music one track at 
a time or record in true stereo; listen to 
previously recorded parts while overdubbing 
others; fix mistakes anywhere on a track with 
punch-in/out capability, ping-pong (i.e., com- 
bining tracks 1, 2, and 3 and mixing them 
onto track 4 — thus freeing them up for over- 
dubbing new parts}; and mix down four tracks 
in stereo (or mono) onto another recorder. 

The built-in two-channel input mixer has 
linear slide faders with LED peak-reading bar 
graph meters allowing careful control and 
monitoring of levels. Use the two front- 
mounted 1/4" phone jacks to input signals 
from either mics or instruments, or a pair of 
RCA input jacks for line level signals. Each 
input channel offers shelving-type equaliza- 
tion with ± 12 db cut or boost at both 100 
Hz and TO KHz. Track selectors let you record 
up to two tracks at a time with Dolby B noise 
reduction. A separate, 4-channel monitor and 
mixer boasts individual gain and stereo pan 
controls for each tape track. 

Other features include soft-touch transport 
controls with a cueing function in the fast 
wind modes, a headphone jack with level con- 
trol, and a pitch control ( ± 15%) which allows 
you to tune the X*15 to instruments, other 
tapes, or generate special effects in record 
and playback modes. 

If desired, you can tap the output signals 
directly off the playback head (bypassing the 
internal mixer) using the four direct-out RCA 
jacks on the side of the machine. This allows 
you to transfer your basic tracks to a larger 
multi-track recorder or mixer with maximum 
fidelity. The X-15 has excellent frequency 
response and signai-to-noise ratio to faithfully 
capture and play back your most demanding 
musical creations. 

THE GO-ANYWHERE MACHINE 

The X-15 is a cinch to carry. With battery 
pack (and batteries) included, the unit is 
about the size of an average dictionary, and 
weighs less than seven pounds! It's the 
perfect tool for keeping a musical diary. Take 
it along to capture that idyllic music-making 
session in the park. Keep it beside you in your 
car or van— so that when something on the 
radio triggers an idea, you can pull off the 
road, hum the Nek, sing the vocal, or make 
a note to yourself about a synth sound or 
drum beat. Can't sleep because some 
strange melody is haunting your thoughts? 
Hook up your keyboard to the X-15 and 
unleash your ideas note-by-note, track-by- 
track . . . This musician's dream machine is 
always ready when you're really cookin'. 



AT HOME IN A MIDI STUDIO 

The X-15 really shines in your - 
home electronic-music studio. You 
can sequence your MIDI keyboard 
synth and drum machine, and record them 
on tape. Then plug in an electric guitar and 
a microphone for capturing some live instru- 
ment and vocal tracks. Finally, biend it all 
together with stereo imaging to create that 
full, rich, 3-D sound you hear on tapes by your 
favorite groups. After the session, unwind by 
listening to these same commercial tapes on 
the X-15. Because this unit operates at the 
standard cassette 1 7/8 ips speed, it doubles 
as a super-quality stereo tape deck. Dub 
tapes from your CD or stereo system using 
the pair of RCA line inputs. You can even add 
your own ideas to these recordings, using 
the left-over two tracks! Put one of these 
dream machines into the hands of a 
musician— budding or pro— and watch the 
creative sparks fly. 

Fostex also makes an optional accessory 
for the X-15, the MN-50 Mixer/Compressor, 
which greatly enhances the recording pro- 
cess. This single output mixer features four 
line inputs (normally used for tape-in}, plus 
an additional selectable mic/line input, and 
a built-in variable compressor. The MN-50 is 
especially useful for merging tracks (ping- 
ponging) with the X-15. As tracks are 
bounced, additional parts may be added 
simultaneously— thereby expanding the 
number of parts in the sub-mixes. Up to 10 
tracks worth of material can be captured 
using this technique, never exceeding 




With the attachable battery pack, the X-15 Mint Studio Is 
ready to go wherever your Inspiration leads. 

second-generation recordings. You'll find the 
compressor useful for adding punch to 
vocals and smoothing out levels from per- 
cussion instruments. This palm-sized unit 
comes equipped for battery or optional AC 
adaptor operation. 

We want to make multi-track home record- 
ing as accessible and affordable as possible. 
So, as a service to you, Cornucopia has put 
together a Fostex Action-Pack of accessories 
that, when purchased together with the X-15, 
provides a special savings bonus. 

X-15 Suggested Retail Price $495.00 



2sr?:xcopia Price 

CAT, NO. 1FX15 $349 ($7.00 P&H) 



X-15 with Action-Pack Accessories 
Suggested Retail Price $703,95 



(cOFGDHCOpia Price 

CAT. NO. 1FX15C $475 ($12.00 P&H) 




MN-50 Mixer/Compressor $55.00 

(2) Punch In/Out Pedals. $24.00 

AC Adaptor $30.00 

X-15 Video Instruction Tape $39.95 

M-3 Microphone $60.00 

Item-By-Item Total . $208.95 



Fostex Action-Pock 

The Fostex Action Pack offers several in- 
dispensable items for the active multi- 
tracker. First, the Pack includes a concise 
VHS video instruction cassette that 
demonstrates a variety of helpful recording 
techniques with the X-15. Second, it includes 
a heavy-duty power supply that saves bat- 
teries during those long sessions at home. 
Two punch in/out pedals facilitate hands-free 
recording when you are both recording 
engineer and performer. With the included 
MN-50 Mixer/Compressor, you get a high- 
quality Fostex M-3 microphone. Bundled with 
the X-15 {see price above). The Action Pack 
saves you almost $230! 



THE 4-TRACK 
RECORDING THAT 
CHANGED IT ALL 

The release of Sergeant Pepper's 
Lonely Hearts Club Band, the watershed 
album by the Beatles and producer 
George Martin, marked the beginning 
of a new era in popular music. The boldly 
innovative music spoke directly to a 
whole generation of people worldwide. 
Especially significant is how this music 
came into being. The Beatles, under the 
creative direction of George Martin, 
realized that the then-new technology 
of multi-track recording made fresh and 
different approaches to music creation 
possible. Music could now be played and 



recorded in bits and pieces, over time— 
with complete syncronization— to be 
assembled (or * 'mixed") into a finished 
work at a later date. Before Sgt. Pep- 
per, most records were made by bring- 
ing the ariist(s) into the studio, and cap* 
turing their live "performance" on tape. 
The Beatles turned the studio itself in to 
an instrument. It was the 4-track 
recorder that allowed them to do this. 
Tracks were recorded, mixed, bounced, 
and blended in creative and unusual ways, 
George Martin even went so far as to 
cut tape apart, randomly respiting it to 
create new "instruments" out of re- 
cordings of traditional ones. Also, the 
Beatles were able to play several in* 
strum ents simultaneously in this record- 
ing, thanks to the magic of multi-track. 



In short, Sgt. Pepper turned the world 
on its ear. introducing the concept of 
an "audio canvas" to an appreciative, 
music -loving public. 

While the impact of their work re- 
mains undiminished (Sgt. Pepper is 
arguably the greatest pop music achieve- 
ment of our time), some things have 
changed. With the introduction of the 
X-15, a 4-track recorder and mixing 
console—which used to weigh hundreds 
of pounds, take up the space of a washer 
and dryer, and cost more than an Italian 
sports car— is now available in a single. 
portable, inexpensive unit. Take advan- 
tage of this new tool. Who knows? The 
world's next 4-track masterpiece may 
be your own . . . 
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Con The Pros!" 



Can a new breed of 4-track 'mini-studio" take on the 

far-more-costly 8-track standard? In many applications, 

you II be hard-pressed to tell the reel score . . . 



Until recently, serious musicians and 
recording engineers had to spend many 
thousands of dollars to equip their home 
studio with an 8-track recorder and mixing 
board to get that professional-sounding 
"big mix" for their aINmportant demo 
tapes , . , 

Now, with the introduction of the Audio 
Technica A T-RMX64, the world of conven- 
ient and affordable 4-track cassette 
mastering takes on a new dimension — with 
equipment specs and features that were 
formerly unheard of in this type of 
"mixer/cassette" unit. 

SOUND FLEXIBILITY 

With 6 input channels, you can mix in- 
struments, microphones, and other sources 
together, record the mix on up to 4 tracks, 
while sending to a house PA. And with a 
choice of either Dolby B and C noise reduc- 
tion and punch-in/punch-out availability on 
any track, you are guaranteed superior sound 
quality every time you record. There's even 
two recording/playback speeds— 3 3/4 ipsfor 
best frequency response (20 to 18,000 Hz 
with 3 dB variance from 40 to 15,000 Hz) 



and lowest wow and flutter (.04% RMS); and 
1 7/8 ips for playback and recording of 
standard-speed cassettes. The electro- 
mechanical design of 3 direct-drive DC 
motors cushioned by a chassis of nearly 50 
pounds provides rock-steady recording 
results. 

PROFESSIONAL FEATURES 

Each of the 6 input channels accept 
balanced or unbalanced mic or line signals 
with patch in/out for every channel. A total 
60dB of available input attenuation guards 
against overloading. Professional features in- 
clude a solo switch that lets you monitor any 
individual input or return. The AT-RMX64 
operates with a studio-quality signal strength 
of + 4 dbm instead of - 10 dbm as most 
mini-recorders do. You can even vary the 
recording speed up to 15% to match any in- 
strument pitch. Two-band parametric EQ is 
available in each input with a choice between 
peak/dip control shelving and continuously 
variable frequency in gain controls. Two aux- 
iliary sends are switchable from pre-EQ and 
fader to post-EQ and fader. You can assign 
all inputs and returns to any of the 4 available 




sub buses. With powerful features like these, 
the mixer section can compete in versatility 
with many higher priced 8-channel boards! 

GROW WITH IT 

The AT-RMX64 is a well-engineered unit 
that will grow with you as your musical and 
recording skills mature. The machine is com- 
patible with both home and professional 
cassettes; its outputs meet all professinal 
standards both as a recorder and a live mixer. 
If you're looking for professional recording 
features in a turbo-charged "mini-studio," the 
AT-RMX64 gives you all you need and more. 

AT-RMX64 Suggested Retail Price $1595.00 



€s>?[jDffieopIa Price 

CAT. NO. 1ATRMX64 $1259 ($30.00 P&H) 



Optional Fostex powered monitors and Fostex 
M-3 microphone are shown on page C-12, For 
World Cfass Audio™ high-bias tapes, see below. 



Rosemary's Revenge 

If a certain past President had been able to specify 2 World Class Audio C-99 tapes, 
his personal secretary might not have lost those crucial 18 minutes . . . 



What Makes A World Class Tape? 

Could it be the extra length? 

World Class Audio™ doesn't manufacture 
C-60 or C-90 cassette tapes like everyone 
else. Theirs are C-66 and C-99, giving you 
6 or 9 extra minutes of what can sometimes 
be crucial recording time. The 66-minute 
tape is ideal for recording material from 
Compact Disks (CDs) and classical LPs hav- 
ing longer program duration. The 99-minute 
tape is perfect for recording 2 shorter CDs, 
LPs, or cassettes on 1 tape. You'll never 
again "come up short" and miss capturing 
that last full song on each album. 

Could it be a "Shell of a Deal?" 

World Class Audio cassette shells have 
been specially engineered and built in the 
USA to overcome the head azimuth problems 
that plague ail other shells on the consumer 
blank-tape market today. First, a special 
"UniPath" bridge piece (see photo) does 
away with the problem of mis-matched shell 
halves forming the tape path. Second, the 
uneven screw-torque and spot-fastening of 
the shell halves has been eliminated by sonic- 
welding of the entire shell seam. This added 
stability assures consistent and reliable per- 
formance. And with the inclusion of polyester 
"creased-sheets" on either side of the tape, 
even packing and tape flow are assured. 
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C-66 cassettes are ideal for recording 
material f rom CDs and classical LPs 
with longer program duration. 



C-99 cassettes are perfect for record- 
ing 2 shorter CDs, LPs, or cassettes 
on 1 tape. 



The unique "bridge 1 * Insert forms a 
" ' unlpsth' ' guide that maintains superior 
head azimuth alignment. 



Could it be a bias toward perfection? 

Choosing the perfect tape for an applica- 
tion is a matter of bias. World Class Audio's 
premium-quality normal-bias tape (120 /^S 
EQ} provides excellent frequency response 
and dynamic range for a wide variety of tape 
recording needs. For cassette machines with 
high-bias (chrome) settings, World Class 
Audio's very fine chromium-oxide tape (70 
nS EQ} may be your preference. High-bias 
tape is recommended for dubbing Compact 
Disks or other demanding source material, 
and is specified by virtually every manufac- 
turer of multi-track cassette machines. 

Could it be a "World-Safe" warrantee? 

What if the cassette tape fails? These 
World Class Audio cassettes are meticulously 
designed not to fail, but in the unlikely event 
one does*— for any reason whatsoever- 
return it to us for a brand new replacement. 



Even if you are paddling down the Amazon 
River, recording exotic jungle sounds when 
your sturdy cassette fortuitously intercepts 
a poison dart—send it in and get a new one! 

0r t could it be our remarkable prices? 

What is the price for all this World-Class 
quality, peace of mind, and headache-saving 
extra length? Just take a look at these 
remarkable values: 

C-66 EVX-l normal-bias 120^5 EQ 
(SsX/KGaCOpia 10-pack price $22.95 
CAT. NO. 1C6GN10 ($2.50 P&H) 

C-99 EVX-l normal-bias 120,<S EQ 
S(£X7[n]QaCOpIa 10-pack price $25.95 

CAT. NO. 1C99N10 ($2.50 P&H) 

C-66 EVX-2 high-bias 70^S EQ 

©SWGCDQCOpia 10-pack price $26.95 

CAT. NO. 1C66H10 {$2.50 P&H) 

C-99 EVX-2 high-bias 70^S EQ 

(£@>~rn]rijC©pia 10-pack price $29.95 

CAT. NO. 1C99H10 ($2.50 P&H) 




Dual Dubbing Droid 



The Hitachi D-W800 won't make the cof- 
fee or put out the kitty, but for computer- 
controfled editing of musical selections, 
sound-on-sound mixing, and high-speed 
dubbing, it's the cream of the crop . . , the 
cat's meow. 

CREATIVE CYBERNETIC CONTROL 

Copying tapes can be time consuming, 
especially if you have to search for the song 
you want first. It can take even longer if you 
want the songs recorded in a certain order 
(such as songs 2, 3, 5, 7, and 8 r or maybe 
even 6, 3, 8, 2, and 5). This becomes mere 
child's play with the D-W800. Its 
microprocessor allows you to play and record 
any songs in any order you want— up to 15 
selections under full computer control. 

After you've programmed in your selec- 
tions, the microprocessor precisely takes up 
the leader tape to prevent losing the begin- 
ning notes of your recordings. While one 
deck plays back your selections, the other 
records them— at twice normal speed, if you 
so specify. Then the record deck stops and 
adds 4 seconds of silence while the play deck 
either fast forwards or rewinds to find the 
next song. When everything is in sync, the 
four motors and smart electronics of both 
decks continue the dubbing process. There's 
virtually no need for you to intervene and risk 
flubbing a dubbing! 




Thedeck'sclear display guides you step- by-* top through 
the process of programming the high-speed edit and 
recording order for your musical preference. Than the 
machine takes over the work! 

SIT BACK AND RELAX 

D-W800 also makes listening to music ef- 
fortless. The Long Pfay mode lets you play 
two tapes sequentially, up to 8 times each. 
This unique feature provides hours of music 
pleasure without getting up to change cas- 
settes. The random program and search 
features let you automatically find the begin- 
ning of any song, jump forward to the next 
song, or program the machine to repeat 
songs over and over. 

There's even a timer function that allows 
the machine to power up in either record or 
playback mode (under control of an ac- 



Its not inquisitive like R2D2, 

and not as chatty as C3PO, 

but watch how it blasts away 

hiss, translates your orders, 

and clones your tapes . . . 

cessory audio timer— see page C- 1 2) to cap- 
ture that special concert broadcast while 
you're away, or awaken you to your favorite 
Vivaldi piece. 

JOIN IN THE FUN 

The D-W800 is an ideal cassette deck for 
singers. Plug in a microphone and sing along 
with music playing on one deck, while record- 
ing everything on the second deck. You can 
also dub over albums or radio broadcasts us- 
ing the machine's line input. 

SUPERIOR SOUND COMES STANDARD 

Its true that feature-for-feature no other 
dubbing deck in this price range even comes 
close to matching this Hitachi machine, but 
all this design sophistication would be for 
naught if the deck didn't provide clean sound. 
No worry here. The D-W800's wide frequency 
response and both Dolby B and C noise re- 
duction provide superior results. The record 
bias circuitry automatically senses and ad- 
justs for all normal, chrome, and metal tapes. 

With features like these, its easy to see why 
the D-W800 is an excellent choice for all your 
taping needs. 

D-W800 Suggested Retail Price $389,00 



(COinE^COpia Price 

CAT, NO. 1HDW800 $229 ($12.00 P&H) 



Optional Sennheiser MS 100 stereo head- 
phones are shown on page C-13. 



SPECIAL Gin- 
To start you off on the right foot. Cornucopia will 
send all purchasers of the D-W800 a FREE World 
Class EVXII C'99 High-Bias audio cassette tape. This 
is our gift to you even if you decide to return the 
tape recorder. We want the first tape you try in this 
unit to be the best available, so that you'll discover 
just how good a Dual Dubbing Droid can be. 



CASSETTE TAPE TALK 

WHAT IS BIAS? 

Bias is a high-frequency signal that the 
recorder applies to the recording head along 
with the audio signal to improve the frequen- 
cy response of the recording. Each tape for- 
mulation has an optimum bias level. 

HEAD AZIMUTH ALIGNMENT 

Head aiimuth alignment refers to the 
degree of perpendicularity between the 
magnetic gap of the tape head and the 
magnetized track of information on the tape. 
Because cassette tape moves slowly, the 
recorded wavelengths of high-frequency 
signals on the tape are very short (2.4 
microns for a 20-kHz signal). In order to 
resolve these tiny wavelengths, the tape head 
must have an incredibly narrow gap (under 
2 microns), and must have accurate azimuth 
alignment. 

If your tape head is out of alignment and 
you play a tape recorded with Dolby noise 
reduction, it will sound distant and muddy 
because of lost high-frequency response and 
also because of Dolby decoding errors 
caused by this loss. 

The physical tolerances of the cassette 
tape shell itself compound this problem. 
Because the pressure pad, spring, and tape 
guide rollers are held in place by the two 
halves on most cassette shells, it is the shell 
that plays the principal role in maintaining 
tape-to-head contact and alignment. Varia- 



tions in the shape of the shell and even in the 
torque of the screws that hold it together 
can affect this critical head-azimuth 
alignment, 

MIXING 

Mixing is the process of combining two or 
more audio signals (from microphones, tape 
decks, musical instruments, or signal pro- 
cessors) into a single new signal with the aid 
of a mixer or mixing console. The mixed 
signal is then usually recorded on tape to 
preserve the mix. 

NOISE-REDUCTION SYSTEMS 

Dolby B— the most common noise- 
reduction system for cassette recording- 
provides up to 10 dB of high-frequency noise 
reduction. The newer Dolby C system pro- 
vides improved performance and up to 20 
dB of noise reduction. 

Another popular noise* reduction system 
for consumer applications is "dbx Type II," 
which is capable of 30 dB or more of broad* 
band noise reduction. 

Both Dolby and dbx noise-reduction 
systems work on the "encode-decode" prin- 
ciple. The noise-reduction system processes 
or encodes the signal during recording, and 
decodes it during playback. The Dolby 
systems are sliding-band companders, while 
the dbx system is a linear compander. 

A ''compander/' or compressor- 
expander, compresses the dynamic range of 
the audio signal during the recording process, 
giving the signal a more uniform level to ride 
over the noise, It then expands the dynamic 



range during playback, restoring the varia- 
tions between loud and soft. Sliding band 
companders are sensitive to a varying por- 
tion of the audiofrequency spectrum. Dolby 
B affects only the high frequencies, and 
Dolby C affects only the mid and high fre- 
quencies. Linear companders like the dbx 
system, by contrast, affect the entire audio 
frequency spectrum, 

OVERDUBBING 

The process of recording tracks at dif- 
ferent times on the same multi-track master 
tape (analog or digital) is referred to as 
overdubbing, 

SIGNAL-TO-NOISE RATIO 

The signal* to -noise ratio (S/N) is the dif- 
ference in dB between the amplitudes of the 
desired signal and the noise that exists under 
no-signal conditions. 

TAPE EQUALIZATION 

Tape recorders boost high frequencies 
according to a "record equalization curve" 
during recording, and reduce them according 
to a "playback equalization curve" on 
playback. Record equalization causes the 
signal to ride over high frequency tape noise 
more effectively. Playback equalization 
reduces high frequencies and noise, so that 
the high-frequency components of the signal 
are returned to their previous levels with re- 
duced noise. Normal Bias tapes use 1 20 j*$ 
playback equalization. High Bias (including the 
premium Chrome-type) tapes use 70 pS 
playback equalization. 



TRACK BOUNCING 

The process of mixing together two or 
more tracks of a multi-track master tape and 
simultaneously recording them on a different 
track of the same tape is called "bouncing." 

TRACK FORMATS 

A track is a magnetized region containing 
recorded in formation that runs lengthwise 
along an audio tape. Cassette recorders con* 
form to one of 3 track formats: 2- track 
monaural, 4-track stereo, and 4-track multi- 
track. 

Monaural tapes are divided in the middle, 
with one track for each half of the tape . The 
active portion of the record or play head sits 
above the first track. When the tape is 
turned over, the second track will be under 
the head gap. 

The 4-track stereo cassette format uses 
two tracks side-by-side in each direction, 
Each head has two gaps that "see" the pair 
of tracks on one half of the tape. Turning 
the tape over allows the head to sense the 
other pair of tracks. Because there are two 
tracks on each half, each track takes up a 
quarter of the tape width. 

The 4*track multi- track format records on 
all four tracks only in one direction and 
employs heads with four gaps. This format 
is used to produce four-track multichannel 
recordings. 

WOW AND FLUTTER 

An expression of the degree of steadiness 
of the tape speed. Slow variations are called 
wow, fast variations are called flutter. 
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Fostex M-3 Microphone 

Complete your sound system with this uni-directional microphone. 
Perfect for vocals as well as instruments. 90-16,000 Hz. 

M-3 Suggested Retail Price $60.00 




S&tfCQGQCOpfa Price 
CAT. NO. 1FM3 



$49.95 

($3.50 F&H) 



Combine outputs of up 
to 6 electronic instru- 
ments with the Boss 
BX-600. This 6 IN/2 OUT 
audio mixer is tailor-made 
for hooking up several 
synths and a drum ma- 
chine to your home stereo 
system or to a set of 
powered monitors. Enjoy 
the convenience of indivi- 
dual volume and pan con- 
trols for each input. This 
high-quality mixer is a 
perfect match for any in- 
struments in this catolog. 



Doss DX-600 Mixer 
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BX-600 Suggested Retail Price $225.00 



©SJcmracopla Price 

CAT. NO. 1HBX60O 



$179 

($600 P&H) 



Korg KMT-60 MIPI-Thru Pox 



Connect up to 6 MIDI in- 
struments to a single MIDI 
sequencer with this flexi- 
ble device. The KMT-60 
MIDI- Thru Box eliminates 
"MIDI delay" that results 
when you use MIDI THRU 
jacks to daisy chain several 
MIDI instruments to- 
gether. With the KMT-60, 
each instrument receives 
the same MIDI data from 
your sequencer— at the 
same time. 




KMT-60 Suggested Retail Price $69.95 



(g®£?E7DG£]COpla Price 

CAT. NO. 1KKWT60 $59.95 ($4.00 F&H) 



Korg Equipment Stands 

The Korg multi-tier equipment stand provides a solid foundation for 
your keyboards, drum machine, sequencers, etc. Featuring lightweight 
aluminum construction, this attractive stand is at home on the road and 
in your studio. It comes complete with a built-in microphone boom, carry- 
ing bag, and two support arms per tier. The stand is available in chrome 
with either 2 or 3 tiers. Order extra tiers and support arms below. 
2Her Stand Suggested Retail Price $240.00 



(S®[?Cn]CaeopIa Price 
CAT. NO. 1K2TKS 



$199 

($15.00 P&H) 



3-Tler Stand Suggested Retail Price $260,00 



(SdXTGDGOCOpIa Price 
CAT. NO. 1K3TKS 



$229 

($18.00 P&H) 



Additional Tier (without support arms) 



(SOfTCDGDCOpfa Price 
CAT. NO, 1KTHC 



$49.95 
($6.00 P&H) 



I Additional Pair of Support Arms 



Cg®c?r7DGflCOpIa Price 

CAT. NO. 1KKSR 



$24.00 

($3.00 P&H) 
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Powered Monitors 

Highly versatile, these self-powered 
monitors accept line feeds from in- 
struments, pre-amps, and recorders. 
Use the Fostex Personal Monitor for in- 
strument monitoring, studio reference, 
remote recording, video production, and 
A/V presentations. Unbelievable sound 
quality from so small a box. 




- ;'* 


Fostex Personal Monitor 
Suggested Retail Price $149.00 


' 






X^TL^COpla Price $124.95 

CAT. NO. 1F630I ($6.00 P&H) 



Accessory Cobles 

10-Foot MuM-Purpose Patch Cable with 1/4" Phone Plug to RCA 
Plug for connecting synthesizer and drum machine OUTs to tape 
recorder LINE INs. Useful for connecting tape recorders to powered 
monitors. Also used for transferring patch data from Akai AX-80 
to a high-quality stereo cassette deck. Comes with RCA to 1/4" 
adaptor for connecting synthesizers, drum machines, and guitars 
to stage amps, effects devices, mixers, and powered monitors. This 
cable meets virtually all studio needs. 



(SSXffiDQOCOpla Price 
CAT. NO. 1RPJ1 



$10.00 

($2.00 P&H) 



RCA to RCA Stereo Cables for connecting audio components. 
Available in three lengths. 



CgcSDimjGOpIa Price ($2.00 ea P&H) 

1 meter oat, no. ihcra201 $3.50 

2 meter oat. no. ihcra202 $4.00 

3 meter CAT. NO. 1HCRA203 $5.00 



MIDI Cables: MIDI connection cables for linking synthesizers, se- 
quencers, drum machines, computers, and MIDI-effects devices. 



(§®CtfDQDCOpIa Price ($2.00 ea P&H) 
2. 5-meter CAT. NO. 1RMSC25 $12 

5.0-meter cat. no. irmscso $16 



Multi-Cable Packs 

Versl-Pack (2 cords) Save 12% 

(2) 10-foot Mufti-Purpose Patch Cables 



SSTJUDGOCOpla Price $18 

CAT. NO. 1WCVP1 ($3.00 P&H) 



Audio Pack (4 cords) Save Over 32% 

(1) 1-meter RCA-RCA 

(2) 2-meter RCA-RCA 



(1) 3*meter RCA-RCA 



(StsXrCDGOCOpia Price $13.90 

CAT. NO. IWCAPl ($4.00 P&H) 



Super Studio Pack (7 cords) Save Almost $18,001 

(2) 10-foot Multi-Purpose 
(1) 1-meter RCA-RCA 



(1) 2-meter RCA-RCA 

(1) 3-meter RCA-RCA 

(2) 2.5-meter MIDI 



©ITEQGOCOpia Price $48 

CAT. NO. 1WCSP1 ($5,00 P&H) 



MIDI-WHAT IS IT? 
WHAT DOES IT DO? 

A few years ago, a wave of excitement 
hit the electronic music industry. After 
months of work, several competing syn- 
thesizer manufacturers agreed on a system 
that enabled synthesizers, drum machines, 
sequencers, effects devices, and home com- 
puters to communicate through a standard 
interface. The implications were massive. 
The response was universal. And best of all, 
the system worked! This significant develop- 
ment was named: MIDI (Musicial Instrument 
Digital Interface). 

THE "INS" AND "OUTS" OF MIDI 
The MIDI system operates on one very 
simple premise— a digital command is either 
transmitted or received, MIDI instruments 
usually have at least one MIDI-IN and one 
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MIDI-OUT jack to send and receive MIDI 
messages, in addition, some MIDI in- 
struments offer a MIDI-THRU jack that out- 
puts the same MIDI message that is received 
by the IN jack— a handy feature for sending 
the same message to two instruments. 

MID) messages travel from the transmit- 
ter's OUT to the receiver's IN via a special 
cable called a MIDI cable. These cables have 
a 5-pin DIN plug on each end that is designed 
to plug into the S-pin MIDI jacks on your 
instrument. 

THE MIDI MESSAGE 

MIDI is a "communication system" and 
therefore has its own language. MIDJ's par- 
ticular language happens to be digital. This 
means that it has only two letters in its 
alphabet (I and 0). All its "words" are spelled 
with some combination of these two 
characters (e,g„ 00001010 or 01 110011), 



These numbers are created electronically 
and are transmitted one at a time (serially) 
at 3 1 .25 Kbaud— very fast! This whole pro- 
cess resembles the data communication 
system used in the computer industry. 

MIDI transmits messages that can include 
the following: the note you play, when you 
played it, the velocity of your keystroke, 
how much aftertouch you used, any program 
(patch) changes you made during your per- 
formance, pitch bend and modulation wheel 
changes, timing information (used to syn- 
chronize several instruments), and system 
exclusive information (often used to send 
patch information to "patch libraries" or to 
transfer information between two identical 
instruments). 

Don't worry! You don't have to under- 
stand the MIDI language to take advantage 
of its capabilities. There are countless pro- 
ducts available that make it easy to use. 



GETTING MIDI TO WORK FOR YOU 

MIDI is designed to allow you. the musi- 
cian, more freedom to control and change 
your instrument setup. This means that in- 
struments equipped with MIDI will not 
become obsolete after only a few years of 
use, like so many other musical instruments. 
Any instrument with MIDI jacks will remain 
useful as part of your studio, because it can 
always be connected to newer equipment as 
you expand. 

There are many ways to create and inter- 
connect MIDI studios. Just remember that 
MIDI messages must "flow" from one instru- 
ment to another (always connect your OUTs 
or THRUs to your INs), and you'll be well 
on your way to enjoying the amazing benefits 
of MIDI electronic instruments. 



Can't Get No 
Satisfaction? 
You Need— 

The 
Equalizer! 



The new audio era with its Compact 
Discs, audio-video sources, home music 
studios, and other fascinating dimensions 
needs a new kind of tool. Enter the Technics 
SH-8066—a graphic equalizer so advanced 
that it sports its own Internal computer for 
automatic equalization— completely 
eliminating the hassle of trying to find the 
best slider settings for flat response. This 
personalized "room acoustics" curve is 
placed In memory (as one of the unit's 8 
preset curves) to compensate for imperfec- 
tions in your listening room. 



WORLD'S FIRST DIRECT-TOUCH EQ 

With the SH-8066, you don't have to fid- 
dle with a long string of adjustible sliders. In- 
stead, a direct-touch control panel lets you 
"draw" with your finger the kind of equal iza- 
tion curve you desire. Simply slide your finger 
across the touch-sensitive control panel, and 
watch the equalization curve appear on the 
fluorescent display of the built-in spectrum 
analyzer. Then press one button to lock this 
curve into place. 

HAVE IT YOUR WAY 

You can choose from 8 preset equaliza- 
tion curves— 3 factory presets (rock, jazz, 
vocal), 4 of your own curves, and the "room 
acoustics" curve calculated by the 
equalizer's internal computer, using its built- 
in pink noise generator and supplied test 
microphone. The unit provides 12dB boost 
or cut (in 2dB steps) at each of 12 frequen- 
cy bands. 

But which curve should you pick? If you 
can't decide, select different curves by press- 
ing the appropriate button and compare the 




• When you're backed into a corner . , . with no 

place to turn . . . and frequencies are stacked 

against you— you need help FASTI 

But one finger is ail It takes to bring instant action. 

No sonic problem Is too big for —The Equalizer! 




Any two of tht curve*, llk« thou •hown above, pin be 
"stacked" for perfect equalization. 

unique sound of each mixture. Or, with the 
"EQ Plus" function, you can stack any two 
curves to get that perfect equalization. Try 
stacking the room acoustics curve with the 



vocal curve to create the equalization curve 
of your favorite singer. 

If you enjoy watching the dynamic ievels 
of a particular song, check out the colorful 
bar graph that lights up on the spectrum 
analyzer display for a fascinating reflection 
of the changing energy content in the audio 
spectrum. Or press one more button and the 
SH-8066 depicts the EQ curve as a series 
of glowing dots. 

JOGGERS & DRIVERS REJOICE 

For those who listen to music all day 
long— while driving, jogging, or working— 
the SH-8066 has another ingenius feature: 
it lets you tape music that is equalized to any 
of your particular specifications. You can, for 
example, record music that is specially 
equalized to fit the characteristics of your car 
stereo or portable headphone cassette 
player. And, with the unit's two-channel (12 
bands per channel) EQ circuitry, you gain ver- 
satile control over two tape decks. The 
SH-8066 helps you get the most from all of 
your cassette-playing stereo systems! 
SH-8066 Suggested Retail Price $500.00 



3ir~ncopia Price 

CAT. NO. 1TSH8066 



$369 ($12.00 P&H) 



Sennheiser Switch-Hitter 

Highest-quality headphones for 
go-anywhere musk pleasure 

What could be better than a single set of head- 
phones for your CD player, cassette deck, syn- 
thesizer, drum machine, and personal portable? 
The Sennheiser MS 100s new design in head- 
phones brings the most out of any audio product, 
and the best of any synthesizer— a very demand- 
ing test, indeed. With a frequency range of 20 
Hz to 20 KHz, the MS 100 headphones are the perfect match for both the 
Technics SL-P3 CD player, and the Hitachi f>W800 Dual Dubbing Deck. "Open- 
Aire" technology permits total listening enjoyment indoors or out, A 4-foot 
cable with standard mini*stereo plug and a 6-foot expansion cable with a stan- 
dard (1/4-inch) stereo phone plug are included. 

MS 100 Suggested Retail Price $85,00 
CAT. NO. ISMS 100 (geramjcopla Price $75 ($4.00 P&H) 




* Cornucopia Shopper Special • 

Get either of these 

two premiums 

for only $5 

when you order 

ANY Item from 

this catalog! 

See HCM's center 

bound-in order form 

for merchandise details <5®ffi?DGac©pl» Price $5 

and regular prices 0N DISK REVUE cat. no. ieodr ($1.00 P&H) 

of these items. £ es J 2? 9 9 ' er CAT - N0 - 1EB *9 (S1.50 P&H) 




Best Of 99'er 
(Book Only} 
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The Great Deception 

All CDs are created equal— but some are more equal than others . 



mm/Mil iimimnm 




There's no question— the Compact Disk 
(CD) player is the hottest home electronics 
product to come down the pike— ever! The 
CD is the most revolutionary change in 
audio since the invention of the LP phono- 
graph record. With the new optical medium, 
the days of scratchy needles and warped 
records are over! Laser pick-ups read the 
digitally recorded music from shiny 4-inch 
discs without even touching the discs 
themselves. Your thousandth playing of the 
music Is virtually the same quality as the 
first— and the music literally explodes from 
your sleepy stereo system, with a crystal 
clarity, dynamic range, and lack of noise 
that — without exception — startles first- 
time listeners , . , 

But you know all this— you've been reading 
about this new music revolution in the 
popular press, and you can hardly avoid hear- 
ing all the better radio stations across the 
country playing the new discs. Chances are 
you have friends who have been raving about 
their new purchase ... or maybe you've 
been curious enough to stop into a local store 
and give the new medium an "ear test," 

If you Ve seen a few of the CD players side- 
by-side, one thing is obvious: they all operate 
pretty much the same— with smooth, motor- 
driven loading trays, digital readouts, random 
programming for making selections in any 
order you choose, plus pretty much the same 
search and skip features. The controls are 
all logical, intuitive to first-time users, and 
don't require reading a lengthy operating 
manual prior to hook-up or use. In short — 
the perfect consumer-electronic product. 

But therein lies the danger to the unwary 
consumer: CD product development is 
already into its fourth generation- 
characterized by subtle-yet-important player 
improvements which open up the doors for 
a major change in the audio-only CD medium 
itself. The most advanced of these fourth- 
generation players must command higher 
prices, yet unfortunately have to compete in 
the marketplace with vastly inferior machines 
that are practically being given away at fire- 
sale prices. And the public is led to believe 
that all CD players are alike— giving rise to 
The Great Deception. 

THE CODE OF THINGS TO COME 

The majority of CD players being sold to- 
day are already technically obsolete— 
because they lack one all-important feature: 
a subcode output port. This will allow a CD 
player to hook up to your TV (through an ac- 
cessory decoder/adapter box) enabling you 
to display stilt pictures (video or computer- 
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generated} relating to the audio material, 
scores, liner notes, lyrics, or other alpha- 
numeric information. Imagine a hot rock- 
video disc with pictures of the stars (get 
ready, Madonna . . .), operas with translated 
librettos, classical recordings with prominent 
orchestral sections displayed, travelogues, 
children's stories, and even encoded MIDI 
signals that trigger synthesizers and drum 
machines— plus orchestrate graphic light 
shows synced to the music! All this will event- 
ually enhance the music content of CDs — 
you surely won't want to miss it by purchas- 
ing an unequipped player . , , 

THE UNIQUE TECHNIQUES OF TECHNICS 

Enter the Technics SL-P3, a fourth- 
generation CD player of exceptional com- 
petence and value. Yes, it's one of the few 
that has a subcode outport port; but it's also 
the only player we know of with several other 
crucial features for the audio enthusiast or 
electronic musician: remote-controlled 
volume, A-B frame marking, auto-pause, and 
auto-cue. 

The wireless (infrared) 
remote control is the 
most complete we've 
seen. You can perform 
virtually every major front- 
panel function from the 
comfort of your couch 
across the room— /n- 
cluding volume adjust- 
mentl Because CDs con- 
tain a much wider dyna- 
mic range than other 
music sources— and even 
differ widely from disc to 
disc— listeners are always 
having to readjust their 
amplifier volume control 
setting every time they 
switch sources or CDs. 
With the SL-P3, volume level can be compen- 
sated for remotely (through special back- 
panel variable line-out terminals) to match the 
output level with your other com- 
ponents—leaving your usual amplifier 
volume level setting alone. The unit even 
memorizes the last output level setting when 
the power is switched off! Virtually every 
member of our staff who has seen this 
remote-volume feature in operation has 
vowed never to buy a CD player without it . . . 

Then there's the A-B frame-marking 
capability, allowing you to mark any two 
points on the disc— not just the beginning 
or end of individual tracks, or indexes within 
tracks— for repeat play. When combined with 




Th« wiroloss remote 
control unit Is so com- 
plete. H even has a 
volume control. 



Technics special auto*pause and auto-cue 
features, it allows precise punch-in and 
punch-out points for digital sound sampling 
(see page C-7) and specialized recording 
needs. Used alone, the auto-pause feature 
puts you into pause at the end of each pro- 
grammed track; auto-cue puts you into pause 
right at the start of the first musical note in 
the next cut. Both are quite useful features, 
particularly when dubbing CDs to tape for 
your car deck or personal portable. 

"FULLY LOADED" UNDERSTATEMENT 

The SL-P3 is Technics top-of*the-line CD 
player. It's fully loaded with state-of-the-art 
features— such niceties as direct access of 
all tracks and index points, a music scan func- 
tion with adjustable time interval, a disc prism 
for viewing the spinning disc from the front 
as well as above, automatic playback from 
an external audio timer (see page C-13), and 
a pre-emphasis compensation circuit (with 
front-panel indicator) for specially encoded 
CD's, Keep in mind that this full spectrum of 
special features just isn't available on other 
CD players— no matter what the price! 

SOLID BENEATH THE SKIN 

The SL-P3 rates right among the very best 
in tracking and error correction — the most 
critical performance specs for the CD 
medium. It lets the SL-P3 play low-quality 
CDs— or CDs with defects such as air bub- 
bles and scratches— that would cause skip- 
ping or noise on many other units. And with 
its optica) deck mounted in a protective 
floating insulator, the SL*P3 has excellent 
shock resistance and reliability. 

UNEQUALED VALUE 

How much would you expect this fine CD 
player to cost? Technics designed it to sell 
for $700. Yet due to the very competitive 
nature of the audio market, we were able to 
make a special purchase, and so can now of- 
fer you this unit for half this figure! 

Sure, you can buy cheaper CD players, but 
none of them hold a candle to the SL-P3. And 
quite frankly, we turned down a slew of less 
expensive units for this catalog— we just 
didn't feel good about selling obsolescence 
and inferior value ... So, if you're ready for 
a revolutionary audio experience, do yourself 
a favor and seriously consider purchasing 
this CD player from us. You'll be glad you did. 

SL-P3 Suggested Retail Price $700.00 



(£®[?K]GGC©pia Price 

CAT. NO. 1TSLP3 $349 ($12.00 P&H) 
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basics 




SYNTHESIZER BASICS 

Keyboard Library 
— Hal Leonard, Publisher 

Explore and discover the basic prin- 
ciples of synthesis and recording. Re- 
prints of articles written by Robert Moog, 
Roger Powell Tom Rhea, and others of* 
fer a wealth of advice and information. 
Step-by-step explanations and graphic il- 
lustrations help clarify technical points. 
An introduction to MIDI is also included. 



Wn'KNlHl 



(SOffODQCeopia Price 
CAT. NO. 1HL01 



$8.95 

($2.50 P&H} 



HOW TO MAKE AND SELL 
YOUR OWN RECORD 

— Diane Sward Rapaport 

Planning your record or tape pro- 
duction takes more that a good 
tune and recording equipment. Get 
the full story on production, 
packaging, marketing, copyrights, 
and more with this revised and 
enlarged edition. Information on 
expenses, time management, 
cassette duplication, new tech- 
nologies, and foreign licensing are 
also included. 



tssrazcopia Price $12.95 

CAT. NO. 1HP01 ($2.50 P&H) 





SYNTHESIZER TECHNIQUE 

Keyboard Library 
— Hal Leonard, Publisher 

This volume details re-creating timbres, 
pitch-bending, modulation, expression, 
soloing, and orchestration. Contributions 
by Robert Moog, Tom Coster, George 
Duke, and others give you practical in- 
struction on mastering the technical and 
artistic potential of your synthesizer. 



{£®£?[n}GDCOpia Price 
CAT. NO. 1HL02 



$8.95 

($2.50 P&H) 



THE COMPLETE GUIDE 

TO SYNTHESIZERS, SEQUENCERS 

& DRUM MACHINES — Dean Friedman 

Your "bible" to the realm of electronic 
keyboard and sound equipment. This fully 
illustrated book shows you what's on the 
market, what they do, and how much they 
cost, ft gives you valuable information and 
hefps you make informed and confident 
purchasing decisions. Also included is a 
summary on music software, a glossary, 
and a list of manufacturers. 



(§®[?0i]e]Copia price 

CAT. NO. 1AMSC01 



$9.95 

($2.50 P&H) 




synthesizers 
and computers 




SYNTHESIZERS AND COMPUTERS 

Keyboard Library 
— Hal Leonard, Publisher 

Open your music studio to the world of 
computers. This book provides a com- 
prehensive introduction to using com- 
puters to control synthesizers. Get an 
overview of digital synthesis, FM syn- 
thesis, Fourier synthesis, and digital 
sampling. A complete section on MIDI 
helps you build a solid understanding of 
this computer-assisted music revolution. 



^2 : : 1": COpia Price 
CAT. NO. 1HL03 



$8.95 

($2.50 P&H) 
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THE PLATINUM RAINBOW 

— Bob Monaco, James Riordan 

A realistic look at the music and record- 
ing industry. Learn how to find a manager, 
producer, and agent; promote yourself; 
get free recording time, and much more. 
This newly revised and updated edition 
includes a complete directory of everyone 
you would ever need to contact. It's a 
must for anyone pursuing a music career. 



(SdM/DOOGOpia Price 
CAT. NO. 1RPR1 



$9.95 

(S2.50 P&H} 



THE SYNTHESIZER & ELECTRONIC 
KEYBOARD HANDBOOK 

— David Crombie 

This is the answer to your questions 
about keyboard instruments. Crombie's 
guide covers the whole spectrum of in- 
struments, playing techniques, music 
theory, MIDI, and more. Illustrations, 
photos, and in-depth explanations make 
mastering keyboards a breeze. Plus, a 
special section profiles the most influen- 
tial and innovative keyboard players of our 
time! 



(SStfCDQaCOpia Price 

CAT. NO. 1RH0 1 



$13.95 

{$2.50 P&H) 





Listen To The Sound Of Silence! 

SONEX Juniors Acoustic Foam 

SONEX Juniors employ a special anechoic wedge pattern for 
ideal sound absorption at all audio frequencies. These attrac- 
tive 24-inch square panels smooth frequency response and 
reduce annoying standing waves. Convenient adhesive mount- 
ing squares and complete instructions come with each box of 
4 panels. Available in 4 appealing colors: natural charcoal, 
brown, blue, and beige. 



ScsXHTDGMOpIa Price 



Blue 
Brown 



CAT. NO. 1SBLU 
CAT. NO. 1SBRN 



$48 (S4.00 P&H) 
Charcoal CAT. NO. 1SCHAR 
Beige CAT. NO. 1SBGE 
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Distinctive Products for Music St Electronics 

1500 Valley River Dr., Suite 250 

P.O. Box 70288 

Eugene, Oregon 97401 

ORDER TOLL FREE 

FOR CREDIT CARD ORDERS CALL 

1-800-828-2212 

MONDAY through FRIDAY 7:00AM - 4:00PM P.ST. 
SATURDAY 8:00AM - 1 :00PM P.ST. 

— Please have /our credit card information and catalog 

ready before calling. We suggest that you use this order 

form to organize your phone order before calling our 

toll-free number. 

For Inquiries & Order Status: 

Tel, (503)-34 1-1029 

MONDAY through FRIDAY 8:00AM — 5:00PM P.S.T. 

HOW TO ORDER: Just fill in our item number, 
the catalog page, the item description, and quantity. 
Then fill in the amount for postage and handling which 
you will find in parentheses (P&H) after the price 
of each of our products in this catalog. 

* To ensure that our prices are kept as low as possible, 
and to provide the speediest service available, we cannot 
accept personal checks or C.O.D. orders as payment for 
merchandise. If not charging to a credit card, please ob- 
tain an appropriate Money Order or Cashier's Check 
made out to "Cornucopia," Thank you for your under- 
standing and cooperation. 

IMPORTANT INFORMATION 

1) Shipping— Whenever possible we will ship 
your order via UPS. Orders shipped to Con- 
tinental U.S. only. Please give us a street ad- 
dress rather than a P.O. Box. Most orders shipped 
within 5 working days, in the unlikely event that 
your order cannot be fulfilled within 30 days, we 
will notify you and give you the option to cancel. 
Items ordered together are not necessarily shipped 
the same day, Your credit card will be billed only 
for items that have been shipped. For over-size 
items, we ship air express to prevent unnecessary 
delays which would otherwise be imposed by truck 
shipment. These items are designated by catalog 
numbers ending in "F." 

2) Manufacturer's Warrantees— All pro- 
ducts sold by Cornucopia are covered by the in- 
dividual manufacturer's warrantees. If you would 
like to see a copy of an exact warranty before 
you buy t just send us a letter (do not phone) with 
a postage-paid return envelope giving us the pro- 
duct number and name to the attention of the 
Warranty Department. 

3) Misprints— Cornucopia makes every effort 
to ensure that the information in this catalog is 
correct. We cannot be responsible for errors. 
However, should you buy a product based on our 
error, it is of course covered by the normal con- 
ditions of our 30-day free-trial period. 

4) Prior Sale and Prices— Cornucopia deals 
with dozens of manufacturers. Sometimes we 
simply sell more than a manufacturer can make. 
In any event, we cannot guarantee to supply any 
product advertised. We will immediately refund 
your money if we find that we can no longer obtain 
a product or if its price rises. 

5) Purchase Orders— We accept written pur- 
chase orders from schools, institutions, and the 
government. Invoices must be paid in full prior to 
shipment. 

THANK YOU FOR YOUR ORDER 




Order Form 



[-JCashier's Check or Money Order enclosed* 

Charge my DviSA □ MasterCard Date Expires 



If you prefer to 

leave the catalog 

Intact for reference 
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The year is 985 A.D. From a balcony just outside your 
royal quarters, you survey your entire kingdom in 
the valley below. Across the valley sits the castle 
of your arch rival. For years, you and the other king have 
shared this valley, bathing for land and food for your peo- 
ple. But now you tire of this status quo— you want the valley 
all to yourself. Your mind searches for a means to this end. 
An all out battle between armies? A fight-to- the-death bet- 
ween you and the other king? No. Experience has taught 
you that only through shrewd economics can you slowly 
weaken your opponent and rule the entire valley. 

Serf City is a two-player economics simulation 
employing both text and graphics. Each player rules 
one of the valley's two kingdoms, both largely subsis- 
tent on wheat crops. Your objective is to increase the 
size, wealth, and population of your kingdom until you 
run your opponent out of the valley. 

But this is no shoot-em-up arcade game. Only sly 
economic tactics can put you on the road to prosperity 
in this simulation. Several devices are at your disposal: 
You can purchase land, establish commerce, build 
wheat mills, plant crops, sell wheat, raise taxes, and hire 
or fire your own army. However, you don't have con- 
trol over everything! The program contains random fac- 
tors simulating unforeseen disasters that can severely 
diminish your kingdom's crops or population. (See 
Figure 1 for a schematic of how all these economic fac- 
tors interrelate.) 

Factors Of The Realm 

When the program starts, you and your opponent 
must enter your names. Then, the main data display 
appears on the screen (see Photo 1). The data screen 
displays the current year— beginning in the year 985 
A.D.— next to your name. A turn lasts one year, but the 
number of years that a game can last is unlimited. A 
game terminates when the players quit or when one 
player has no more population or land. 

The main data display also lists your initial economic 
resources. Both players begin the game with 12 units 
of land, 90 people, 500 gold pieces, and 500 bushels of 
surplus wheat. The land is occupied by 2 units of com- 
merce and 1 mill, leaving 9 units for farming. 

After you've briefly studied the data display, you 
begin play by pressing the key corresponding to the 
economic device you want to manipulate. It's time to 
don your royal economic thinking cap and commence 



your most cunning ruling strategy! Prompts guide you 
through the rest of the simulation. When you complete 
entering data for the current year, press [RETURN] or 
[ENTER] . Now, it's your opponent's turn. When your op- 
ponent has finished entering data, press [RETURN] or 
[ENTER] again to display the year- end economic report, 
which is based on the decisions made during your last 
turn (see Photo 2). The program then shows your up- 
dated score on the main data display during your next 
turn. 

Population 

Population varies each year, due to births, deaths, im- 
migration, and emigration. And these factors fluctuate 
depending on your kingdom's overall prosperity— a 
healthy food supply, reasonable tax rates, and a suffi- 
cient work force. To increase your population, for ex- 
ample, feed your people more [see "Food" section), mak- 
ing sure that you have enough field and mill workers 
to produce the extra food you need. Feeding your peo- 
ple less reduces your population. Population can also 
drop when the personal tax rate is too high (see "Per- 
sonal Tax" section); people may move to other 
kingdoms with lower taxes (but never into your oppo- 
nent's kingdom). If your population drops to zero, your 
kingdom falls, and your opponent rules the entire valley. 

Employment 

The program allocates portions of your population to 
work in your kingdom's fields, mills, and commerce. 
Field workers are your highest priority— without them 
you have no wheat to process for food. Therefore, the 
program automatically allots enough people to harvest 
all of the land you have planted. If you have sufficient 
population, the program then allocates any additional 
people to work in mills. Next, the program makes com- 
merce workers out of any other people you have after 
fully staffing your fields and mills. Finally, the program 
considers any leftover population to be unemployed. 

Commerce 

The program expresses all merchant trade in terms 
of units of commerce, each unit costing 500 gold pieces 
and occupying one unit of land. Your compensation is 
the benefits of taxation (see l 'Commerce Tax" section). 

You can place only one unit of commerce on each unit 
of land not occupied by mills. If your population is too 
small for the number of commerce units you own, some 
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Photo 1 

From the main data display, you can select and 

manipulate any of the economic devices you 

have at your disposal- 



Photo 2 
After each turn, the program displays the year- 
end economic report, listing the status of the 
economies of both kingdoms. 



Photo 3 

The map of the valley depicts land, mill, and 

commerce ownership by painting each 

kingdom a different color. 



"It's time to don your royal economic 

thinking cap and commence your 

most cunning ruling strategy!" 



shops must close, thus 
reducing the flow of taxes. 
To buy units of com- 
merce, press [Ml to select 
the Map option from the 

main data display (see — ^— — — ^^— ^— 
Photo 1). A map of the 

valley appears, depicting your land and your opponent's 
land in different colors (see Photo 3). Position the cur- 
sor on top of the land you already own (see appropriate 
Control Capsule for cursor movement keys}. Press [C] 
for Commerce, and a graphic symbol appears in place 
of the cursor to indicate the new addition. But, if you 
don't have the 500 gold pieces required to establish a 
unit of commerce, the symbol does not appear. 

Mills 

Mills produce flour from the wheat you buy or harvest. 
A larger population requires more mills. Without at least 
one operating mill, all your people will starve. On the 
other hand, running too many mills pulls people out of 
commerce, reducing commerce-tax revenue. 

A fully staffed mill (14 workers) produces enough food 
for 100 people. Understaffed mills produce less wheat— 
or with no workers, shut down entirely. 

A new mill costs 1,000 gold pieces. To construct a 
mill, press [M] from the main data display to view the 
Map. Move the cursor on top of your own land, press 
[M] for Mill, and a graphic symbof representing the new 
mill appears on you land. Build as many mills as you 
want (only one per land unit), as long as you have 
enough open land and lots of gold! 

Pood 

Your food supply relies on 3 factors: the number of 
mills operating; the number of people available to work 
in the mills; and the amount of wheat available for 
consumption. 

Without enough food, your people will starve or move 
to another kingdom, reducing your personal-tax 
revenues (see "Personal Tax" section). Feeding your 
people slightly more than they need results in more 
births, fewer deaths, and an influx of people to your 
kingdom— which increases personal-tax revenue. 
However, large-scale over-feeding results in too many 
births, too few deaths, and too many emigrants— which 
eventually leads to over-population and an unstable 
economy. Overpopulation leads to high unemployment, 
with people depleting the food supply but not working 
to compensate for what they consume. 

To decree the amount of wheat available for food, 
press [W] to select the Wheat option from the main data 
display. When the Wheat option menu appears, select 
Feed the People, and enter the number of bushels you 
want to feed your kingdom. Maintaining your current 
population requires a supply of at least 5 bushels of 
wheat per person. 
20 © Home Computer Magazine 1985 Volume 5, No. 6 



Wheat Surplus 

Surplus wheat includes 

all the wheat you harvest or 

purchase each year. As in 

real life, your yearly 

harvests vary. Serf City 

contains a random factor 

simulating yearly variances in harvests, such as bumper 

crops due to favorable conditions, or crop failures due 

to swarms of locusts. 

You can allocate your surplus wheat however you 
wish— sell it for gold, plant it as seed, process it as food, 
or put it in storage. You may even want to use wheat 
as a commodity, buying bushels when the wheat price 
is low and selling when the price is high. But if you leave 
your wheat in surplus too long, rats might eat large por- 
tions (possibly all) of it. 

Wheat Storage 

Store your wheat that is not being used. To store 
wheat, press [W] to select the Wheat option from the 
main data display. When the Wheat option menu ap- 
pears, select Wheat in Storage, and enter the total 
number of bushels you want to store. For example, if 
you want to add 20 bushels of wheat to the 50 bushels 
you already have in storage, simply enter "70." To take 
all of your wheat out of storage, enter "0" for the amount 
of bushels in storage, and the program automatically 
moves all your wheat into surplus. Now you can allocate 
the wheat any way you want. 

Seed Planted 

The amount of wheat you plant as seed determines 
the size of next year's harvest and the number of peo- 
ple required to work in the fields. You can plant up to 
10 bushels on each unit of plan table land— land not oc- 
cupied by mills or commerce. Planting more than 10 
bushels per plot of land wastes the excess wheat seed. 

Each bushel of seed planted requires one person work- 
ing in the fields. Therefore, planting too much seed pulls 
workers from mills and commerce to work in the fields. 
And with no mill workers, your kingdom starves— even 
if you have a bumper crop! Let's say you have a popula- 
tion of 100 and plant enough wheat to put 95 workers 
in the fields, leaving only 5 people to work in the mills. 
These 5 workers cannot produce enough food to ade- 
quately feed your entire kingdom. 

To plant seed, select the Plant Seed option from the 
Wheat option menu, and enter the desired amount. 

Total Land 

This total on the main data display represents all of 
the land you own. The only restrictions on the amount 
of land you can own are the dimensions of the screen 
and your own financial resources. The cost of land varies 
from 25 to 150 gold pieces— higher wheat prices raise 
the price of land. 



Remember that every time you add a unit of com- 
merce or a mill, you have one less unit of plantable land. 
Therefore, while expanding your kingdom, be sure to 
purchase enough land for crops to feed your people. 

To acquire land, move the cursor to a plot of land that 
is adjacent to land you already own, and press (L] for 
Land. If you have enough gold to pay for this land, your 
color appears at the cursor's location. 

Soldiers 

You need soldiers to capture land from your opponent 
and to protect your own land from similar attacks. To 
seize a unit of your opponent's land, you must expand 
your kingdom's boundary until it touches your rival's 
boundary. Then move the cursor on top of your oppo- 
nent's land (adjacent to your land), and press [L]. If you 
have enough gold to pay for the land, and enough well- 
paid soldiers to defeat the opposing army, the land is 
yours. However, as in any war, you pay a price— you 
lose a random percentage of soldiers. 

To hire or fire soldiers, press [S] for Soldiers on the 
main data display, select either Hire or Fire, and enter 
the number you desire. Keep in mind that hiring soldiers 
pulls people out of your work force. Creating a large ar- 
my to protect your lands may not leave enough people 
to work in the fields, mills, or commerce. On the other 
hand, too few soldiers may be an open invitation for your 
opponent to seize your lands. 

Soldiers' Pay 

You must pay every soldier an annual fee. The more 
you pay your soldiers, the harder they fight in battle. 
However, paying one soldier 100 gold pieces is not as 
wise as paying 5 soldiers 20 gold pieces each. And even 
in the 10th century, soldiers have their standards— pay 
your soldiers too little, and they will desert your 
kingdom, thereby reducing your population. 

To set army wages, select' the Pay option from the 
Soldiers option menu, and enter the amount you want 
to pay each soldier per year. 

Gold Pieces 

Gold is essential to the financial success of your 
kingdom. You can use gold to purchase land, wheat, 
mills, and commerce. You can acquire gold through tax- 
ation (see "Personal Tax" and "Commerce Tax" sec- 
tions), or by selling wheat you have already harvested 
(see Wheat Surplus section). 
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Figure 1 

Hiis diagram illustrates some of the intricate interrelationships that you 

must control to preserve and enrich your serf-based economy. 

Commerce Tax 

This tax is placed on your mills and the merchants 
engaged in commerce. Commerce-tax revenue varies, 
depending on the number of workers in mills and com- 
merce and the prosperity of your people. 

The tax also affects the number of people that can 
work in commerce and mills. For example, if you set 
the commerce tax at 10 percent the merchants can 
employ 22 people per unit of commerce. At 30 percent, 
your merchants can afford only 18 employees per unit 
of commerce. Therefore, if you set the tax rate too high, 
the unemployment rate rises as some shops must close. 
Set the rate too low. and your revenues diminish, The 
maximum commerce- tax rate is 69 percent— commerce 
will not tolerate a higher tax rate. 

Personal Tax 

You can also establish, raise, and lower a personal tax 
to generate revenue based on population and the peo- 
ple's prosperity. 

When over- taxed, your people spend less, reducing 
your commerce-tax revenue. Over-taxing may also drive 
people away and cause more deaths and fewer births. 
To set the personal tax rate, select 
[T] for Tax from the main data 
display, press [1] to select the per- 
sonal tax rate, and enter the percen- 
tage you desire. Like the commerce 
tax, the maximum personal tax rate 
is 69 percent— any higher and the 
people will revolt. 

For your type-in listings, see HCM PROGRAM 
LISTINGS CONTENTS. ^ 
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CELL MATES 



by William K. Balthrop 
& Wayne Koberstein 

HCM Staff 



How complex is a living cell? Is it a static structure— or a dynamic system? 

How do symbiotic organisms make all cellular life possible? 

Find some answers with this fascinating bio-simulation. 



fT^\here is more going on inside a living cell than 
meets the eye. Even the most powerful 

X. microscopes have not yet revealed the entire 
story— the secret life of the ceil. Ask most people what 
they know about this basic life unit, and their reply, if 
any, may invoke a static picture of the cell and its in- 
terior: the cell wall, the nucleus, and "a bunch of little 
floaty things." But when biologists look closer at these 
little floaty things, they see participants in an incredibly 
complex, wonderfully cooperative, and dynamic 
ecosystem; for the metabolism of a living cell involves 
some strange and alien participants who apparently 
learned to live together millions of years ago. Directing 
this metabolic dance, communicating with each cell 
part through encoded molecules, is the nucleus. Some 
of the participants— called organelles— possess their 
own DNA (deoxyribonucleic acid) and reproduce 
themselves independently from the nucleus. Together, 
they are all Cell Mates. 

What if you could place yourself at the center of this 
dance— consciously balancing the entire system mo- 
ment by moment? There may be no better way to ap- 
preciate just how dynamic and basically cooperative 
this system is. We can't literally perform such a miracle. 
but we can give you Cell Mates, a simplified computer 
simulation that places you in the role of the nucleus, 
the cell's "choreographer." 

The Major Performers And You 

Plant and animal cells each have a somewhat different 
cast of dancers. But in both cases, each kind of organelle 
has a specific role to perform. In animal cells, some 
organelles, called ribosomes, manufacture various pro- 

SpeciaJ thanks for technical advice goes to W.R. Slstrom, University of Oregon 
Department of Biology. 



teins. Another group, the Golgi apparatus, "packages" 
these proteins for internal use or secretion (export). 
Lysosomes are the garbage collectors. And tiny mobile 
chemical plants, called mi toch on diia, supply energy for 
all of these activities. 

Although these organelles perform the cell's main 
functions, there are many other participants perform- 
ing minor, but essential parts. Because of the difficulty 
in portraying all of the cell's diverse components, these 
minor players are beyond the scope of Cell Mates. 

In Cell Mates, you direct the show, allocating energy 
to these 4 essential functions: protein production, waste 
disposal, ribosome production, and protein export. Your 
goal is to direct these functions in such a manner that 
the cell is able to divide— effectively producing two new 
cells in its place. When the cell divides, you receive a 
total score. The less time you take to reach cell division, 
the higher is your score. 

You must meet certain requirements before the cell 
can divide: You must double the supply of protein as 
well as the number of several internal components (such 
as the ribosomes): and you must support the larger fami- 
ly of surrounding cells by exporting protein. 

After displaying the title, the program presents the 
actual playing screen. This screen contains a graphics 
representation of the cell (in the upper-left corner), and 
12 indicators that show the status of the various pro- 
cesses in the cell. You can gauge your progress by view- 
ing these indicators. Some of the indicators contain 
areas highlighted against the background color. To 
maintain and eventually reproduce the cell, you must 
manipulate the cell's life processes so that the pointers 
remain in these "safe" areas. Indicators that contain 
no distinguished area show the actual level of energy 
going to specific activities. 



Millions of years ago, life wasn't what 

it is today. In the still waters of land-locked 
lakes and ponds, primitive single-celled 
creatures without true nuclei learned to ob- 
tain energy and reorganize materials 
through ingenious chemical processes. 
These were the ancestors of the organelles; 
for as Jife became more and more or- 
ganized, such specialized organisms 
became permanent fixtures within higher 
Irfeforms. Some— such as the chior- 
oplasts— Integrated themselves into the 
first true plants, capturing energy from the 
sun for use by the entire organism. 
Others— such as the mitochondria— took 
oxygen from the atmosphere (mostly pro- 



THE SECRET LIFE OF ORGANELLES 

duced by the activity of the chloroplasts} 
and used it to "burn" complex molecules 
as an energy source for animal Jife. Even 
today, these organelles possess their own 
DNA, and reproduce themselves in- 
dependently of the organisms they sup- 
port. (For example, mitochondria in a fer- 
tilized egg cell come partly from the mother 
cell and partly from the sperm— and as this 
cell divides, each new ceil starts off with 
half the mitochondria of a mature cell.) 
Why Life chose to organize itself in this 
way is a question that has preoccupied 
many people— notjust the biologists who 
discovered these facts. For whatever 
reasons, the organizing process was 



primarily cooperative, rather than com- 
petitive. It is still an open question whether 
organelles five for the sake of the higher 
organisms— or whether we are living for 
them. What is apparent is that all the 
players in this game have a total stake in 
the system. Neither the organelles nor the 
organisms in which they reside could Jive 
without each other. The fact that each 
maintains a separate genetic indentity ac- 
tually serves to dramatize the cooperative 
nature of their relationship. Of all life's 
mysteries, this may be one of the most 
curious and wonderful. 

[For more on this subject, read The Lives 
of A Ceil by Lewis Thomas.— Ed.] 
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We have incorporated a delay factor into the simula- 
tion, representing the real-world lag between the initia- 
tion of an action and its effect. This delay is not 
constant— it varies with internal and external condi- 
tions. Because of this built-in lag, any action that you 
take does not immediately show up on the screen 
indicators. 



Dividing Energy 

This simulation focuses 
on the 5 most important 
cell components; the mito- 
chondria, the nucleus, the 
lysosome, the ribosome, 
and the Golgi apparatus. 

Mitochondria— In an- 
imal cells, mitochondria produce ATP (adenosine 
triphosphate)— life's most available source of chemical 
energy. Similar organelles in plant cells— the 
chloroplasts— actually perform photosynthesis (the con- 
version of light into energy). All of the cell components, 
including the mitochondria themselves, use ATP as 
their energy source. Without this substance, the cell 
would not be able to carry out any activity. Mitochon- 
dria manufacture ATP by combining products of 
available nutrients with oxygen (and emitting carbon 
dioxide as a waste product). Thus, when cellular 
biologists talk about respiration, they are talking about 
a process that occurs inside the mitochondria. The 
amount and quality of available nutrients directly af- 
fect the amount of ATP that the mitochondria can 
produce. 

Mitochondria are mobile, and can move to the areas 
of the cell where energy is most needed. Most animal 
cells contain anywhere from one to hundreds of 
thousands of mitochondria. For the sake of simplicity, 
our cell representation contains only one. To increase 
the energy allocation to any of the cell's components, 
simply move the mitochondrion to the corresponding 
organelle symbol by pressing the appropriate key (see 
the Control Capsule). Once the mitochondrion reaches 
the designated organelle, it automatically starts produc- 
ing ATP. The mitochondrion does not manufacture ATP 
while it is in transit between cell parts, 

Nucleus— The nucleus is the cell's control center— 
the "central computer." It sends signals in the form of 
encoded molecules to each part of the cell, telling it to 
carry out various operations, (In addition, the nucleus 
carries genetic information in its DNA that determines 
the form of new cells resulting from cell division, or 
"mitosis.") Again for simplicity, we have symbolized 
the message-sending activity of the nucleus with one 
example: the message to increase production of 
ribosomes. Of course, the nucleus requires energy each 
time it sends a message. 

To allocate more energy to the production of 
ribosomes, press N. The mitochondrion responds by 
migrating to the nucleus. Once the mitochondrion 
reaches the nucleus, it begins producing ATP. The in- 
crease in energy shows up on the screen indicator la- 
beled RTB.ENIRGY (energy for the ribosome-production 
message). 

As you allocate this energy, the RIBOSOMES pointer 
shows an increase by moving to the right. If you direct 
the mitochondrion away from the nucleus, the 
RJB.ENERGY indicator shows a decline, and the RIBOSOMES 
indicator ceases to increase. 

Ribosomes do not live forever, They die occasional- 



". , . when biologists look closer 

at these little floaty things, 

they see participants in an incredibly 

complex, wonderfully cooperative, 

and dynamic ecosystem/' 



ly, and become part of the cell's waste. You need to 
replenish your supply of ribosomes occasionally to 
maintain their numbers, 

Ribosomes— Ribosomes produce protein. These 
tiny organelles are attached to the endoplasmic 
reticulum— a convoluted membrane extending out from 
._,^^^^_^^^^^__ the nucleus. The ribo- 
somes assemble various 
proteins according to pat- 
terns supplied by the 
nucleus. Although we sym- 
bolize the ribosomes in a 
discrete corner of our cell, 
in reality they are more 
evenly distributed. 
Protein is the cell's prime 
material. Before a cell can reproduce, it must double its 
original supply of protein. The speed at which ribosomes 
produce protein depends on the total ribosome quanti- 
ty. If you need to produce protein at a faster rate (to keep 
up with the protein exportation rate, for example), you 
must increase this quantity. (See the Nucleus section 
above for directions on increasing the ribosome count.) 
Press R for Ribosomes to allocate energy to the pro- 
. duction of protein. This signals the mitochondrion to 
migrate toward the ribosomes (upper-right corner of the 
cell area). Once the mitochondrion reaches the 
ribosomes, the PRO.ENERGY indicator shows an increase 
as the protein energy level ascends. This increase in 



Photo 1 
Cell display from IBM ver- 
sion at top left shows 
(clockwise from display's 
upper-right): protein- 
producing ribosomes; 
waste-eliminating 
lysosome; and the convo- 
luted Golgi apparatus 
where the mitochondrion 
(green) is supplying ATP 
energy for protein export. 
Nucleus is at center with 
extending endoplasmic 
reticulum membrane. 



Photo 2 
As the waste level con- 
tinues to increase (as 
shown by waste in- 
dicator), the mitochon- 
drion produces no ATP 
while traveling from the 
Golgi apparatus to the 
waste-elimina ting 
lysosome at lower-right, 



Photo 3 
Now at the lysosome, the 
mitochondrion's ATP 
energy goes toward 
eliminating cell waste 
products— and in the nick 
of time, waste levels begin 
to decrease. 
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energy shows up in the PROTEIN indicator. But, as we 
stated, to achieve the desired increase in protein, you 
may need to increase the number of ribosomes first. 

Lysosomes- The lysosomes are the cell's 
housekeepers. They carry degradative enzymes and 
travel around inside the cell collecting and digesting 
larger chunks of waste composed mostly of worn-out 
cell parts. This waste is always accumulating, so you 
must frequently budget energy for lysosome activity. 

As the amount of waste in the cell increases, the 
WASTE pointer moves to the right. The only way to 
reduce the level of waste is to increase the amount of 
energy allocated to waste disposal. To do this, press L 
for Lysosome. In response, the mitochondrion moves 
to the lysosome symbol at lower-right corner of the cell. 
Once the mitochondrion arrives, the energy level shown 
by the WASTE ENERGY indicator increases. After the 
energy reaches a sufficient level, the amount of waste 
starts to decrease as the lysosomes do their job. 

Golgi Apparatus— Your cell is also in the import/ex- 
port business. Few cells can survive without the aid of 
other cells, so you must not only support your own cell, 
but those cells surrounding you. You must supply these 
cells with the protein they need for their existence, and 
in return you will receive protein from them— some of 
the nutrients vital to the ^^^^^^_^^_^^^_ 
production of ATP. The 
Golgi apparatus is respon- 
sible for exporting protein 
to other cells. As a secon- 
dary role, the Golgi ap- 
paratus spends a small 

percentage of its total energy packaging up waste and 
sending it out of the cell. If you fail to export sufficient 
protein, both the level of imported protein (IMPORT PRO.) 
and the nutrient level (NUTRIENTS) decline. 

To increase the amount of protein that you export, 
press G for Golgi apparatus. The mitochondrion 
responds by moving towards the lower-left corner of the 
cell area to the Golgi apparatus symbol. Once the 
mitochondrion reaches the Golgi apparatus, EXPORT 
ENERGY begins to show an increase. If you have a sup- 
ply of protein, EXPORT PRO. also shows an increase. 

The rate at which you can export depends entirely 
on how much protein is available. As you export pro- 
tein, PROTEIN LEVEL declines. As the protein level 
decreases, EXPORT PRO. starts to decrease. All of the pro- 
tein you export must come from the protein you have 
produced (shown on the PROTEIN LEVEL indicator). 

Additional Factors— The AGE display indicates the 
passage of a relative amount of time. The AGE counter 
does not represent any real time frame— to make the 
simulation playable, we have accelerated certain 
aspects of the cell's metabolic system, while slowing 
down others. 

The older the cell gets, the harder it must work to pro- 
duce protein (or ribosomes). You may also notice that 
the average amount of nutrients and imported protein 
also drops off with age. Many factors affect an individual 
cell's lifespan— too many to explain here. But every liv- 
ing cell has a built-in "time limit": The cell must 
reproduce within a specific period of time, or it will die. 
Our model reflects this basic fact. 

The NUTRIENTS indicator shows the cell's current food 
supply. The mitochondria use these nutrients to 
manufacture ATP, In order for the cell to reproduce, the 
pointer must be in the highlighted portion of the display. 

The IMPORT PROTEIN indicator shows how much pro- 
tein is available from the surrounding cells. This pro- 
tein contributes to the cell's protein level. In order to 
reproduce the cell you must move the pointer to the 
the highlighted area. 

The INTERNAL TEMP indicator shows the cell's current 



"Tiny mobile chemical plants, called 

mitochondria, supply energy for all of 

these activities. 9 f 



temperature. The optimum temperature is directly at 
the center of the indicator. The highlighted area is the 
safe zone for the cell. If the pointer leaves this area, the 
cell dies. Even if the pointer remains in the safe zone, 
high and low temperatures (relative to center) affect the 
efficiency of every metabolic operation. 

Most individual cells have little control over internal 
temperature when the external temperature goes out- 
side a life-supporting range. Therefore, the "generic" 
animal cell that we depict in this simulation depends 
on the temperature of the tissue of which it is a part. 
If the cell doesn't adequately perform its part in this 
tissue structure— neither maintaining itself, nor supply- 
ing needed protein to the surrounding cells— its exter- 
nal environment tends to degrade. This can cause a drop 
in external temperature, as well as a shrinking nutrient 
supply. Normal cell activity usually maintains a safe in- 
ternal temperature. If the energy levels for ribosomes, 
export, waste, or protein increase, the internal 
temperature also increases slightly. But it is more im- 
portant to ensure a steady external temperature by ex- 
porting enough protein to maintain the health of the en- 
tire tissue. If the external temperature does become ex- 
cessive due to high mitochondrion activity, you can 
press M to send the Mitochondrion to its neutral, inac- 
^_^^__^^^^^^^_ tive corner. 

Of course, the external 
temperature sometimes 
goes outside a safe range, 
no matter what an in- 
dividual cell does. If it re- 
mains outside this range, 
the cell will die— which, as they say, is Life. 

Life Goes On 

A BASIC computer program can only "scratch the 
surface" of a living cell's complex nature. While being 
purely fun to operate, Cell Mates should also serve to 
awaken your curiosity about this fascinating subject. 
Perhaps just knowing that your very life depends on the 
activity of microscopic creatures with their own separate 
genetic identities will contribute to your curiosity. As 
biologists continue to unravel the mysteries of cells in 
general, and organelles in particular, you may be in a 
better position to understand and appreciate this new 
knowledge. Here's to a lifetime of learning about life 
itself! 
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Cell Mates 


Key 


Function 


M 


Move mitochondrion to home position— 




upper-left corner of cell area 


G 


Move mitochondrion to Golgi apparatus— 




lower-left corner of cell area 


L 


Move mitochondrion to lysosome— lower- 




right corner of cell area 


R 


Move mitochondria to ribosomes— upper- 




right corner of cell area 


N 


Move mitochondria to nucleus— center of 




cell area 


Q 


Quit option— exit simulation 



HCM Glossary terms: ATP, DNA, ecosystem, endoplasmic reticulum, 
enzyme, Golgi apparatus, lysosome, organelle, metabolism, mitochon- 
drion, nucleus, protein, respiration, ribosome, symbiotic. 

For your type-in listings, see HCM PROGRAM LISTINGS CONTENTS. 
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HSEHFEH 




The 



Nano Assembler 



by Roger Wood 

HCM Staff 

This companion to NanoProcessor 

shows you how an assembler can 

provide easy access to machine 

language— by translating simple 

instructions into the computer's 

native tongue. 



In the last issue [HCM Vol. 5, No. 5), we presented 
NanoProcessor, a program that introduced the con- 
cepts of machine-language programming. This pro- 
gram demonstrated how a microprocessor works at 
its most fundamental level. Although entering and 
running simple programs on the NanoProcessor can 
be fun, longer and more complicated machine- 
language routines are another story. Even with short 
programs, you probably discovered what a time- 
consuming and error-prone process it can be to enter 
machine language one bit at a time. 




To alleviate the difficulties involved in working 
with machine language, early computer users 
created programs called "assemblers," An 
assembler is a human-to-machine translator, It operates 
from a "dictionary" of mnemonics (a combination of 
letters that humans can understand), translating these 
mnemonics into the numbers of machine code. Using 
assemblers, you can write a program with the more easi- 
ly remembered mnemonics, and let the computer create 
the actual machine language (the ones and zeros). 

Thus, we present the NanoAssemblen a program that 
will teach you how to use assemblers. With the 
NanoAssembler, you will be able to write long, com- 
plicated programs for the NanoProcessor much more 
easily than you would using machine language. 

Source Code To Object Code 

You may find that many people refer to "assembly- 
language programs" and "machine-language pro- 
grams" interchangeably, as though they were the same 
thing. Actually, an assembly-language program is a text 
file— known as a "source file"— that the computer can- 
not execute directly. It is simply a series of text lines 
comprising mnemonics, numbers, and labels. Before 
the computer can run such a program, the source file 
must be "assembled" or translated into a machine- 
language file— also known as an "object file." 

Take a look at Sample Program 1 , which you can load 
and run on the NanoProcessor. You may recognize this 
program, as it is identical to Sample Program 1 in the 
last issue. The two left-most columns, entitled Addr and 
Code, contain the machine language, (object code), 
which makes up the program. You can enter this ob- 
ject code bit by bit, or you can enter the more easily read 
and (with some training} understood assembly language 
(source code), contained in the Line, Label, Mnemonic, 
and Remark columns. The Remark column is like a REM 
statement in BASIC. It makes the program much easier 
to read and understand. 



Our NanoAssembler package consists of two BASIC 
programs: the NanoEditor and the NanoAssembler. The 
NanoEditor is a simple text editor that lets you enter 
your program as source code and save it to disk (or alter- 
natively tape on the Atari, Commodore, and TI com- 
puters). NanoAssembler can then read and translate 
that file into a corresponding file of object code, which 
you can save to disk or tape. You can then load the ob- 
ject code into the NanoProcessor arid run it. 

Creating A Program 

We will use Sample Program 1 to demonstrate how 
the NanoEditor and the NanoAssembler work. To start. 
Load and RUN The NanoEditor. You begin with this 

menu: DEDIT 

2) FILES 

3) PRINT 

4) EXIT 

Choose the Edit option, which allows you to create 
and modify files. The Editor now displays the command 
prompt: CMD. You may enter one of 5 single-letter 

commands: 



Command 


Function 


A 


Add a line of text 


E 


Edit a line of text 


D 


Delete a line of text 


I 


Insert a line of text 


L 


List 



To begin creating a new file— in this case Sample Pro- 
gram 1— press A. In response, the Editor displays line 
00 1 , with a flashing cursor waiting for your input. For 
each line of source code, the Editor provides a line 
number ranging from 001 to 200. When you enter the 
Add-a-line mode, the program always displays the cur- 
sor on a new line of source code— one line past the last 
line in memory. You can automatically advance to the 
next line by pressing [ENTER] or [RETURN] . To exit the Add- 
a-line mode, press the [ESCAPE] key (see your computer's 
Control Capsule if your machine does not have an 
Escape key). 
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Now enter the contents of the Label, Mnemonic, and 
Remark columns. Because our Editor is in BASIC, your 
text input will be slower than with a full-blown word 
processor. The Label column is empty in line 00 1 of our 
sample program, so press the proper key or key com- 
bination (see your Control Capsule) to tab into the 
Mnemonic field. (We will explain labels below.) Now type 
in the first instruction: LDA#3. You must enter the text 
exactly as it appears in the listing, or the NanoAssembler 
program will not interpret the code properly. Make sure 
there is no space between the A and the #. You must, 
however, place a space between the # and the 3. 

This spacing is critical because the Mnemonic field 
actually consists of two sub-fields; and the space acts 
as a separator for these sub-fields. The left sub-field is 
the "op-code," or instruction field, which defines the 
actual instruction. In line 001, the op-code is LDAtf. The 
right field contains the "operand." The operand is either 
a two-nibble address or a single-nibble quantity to be 
loaded or stored in a register or memory location. It 
defines the number that the op-code is to operate on. 
In line 001, the number 3 (%0011) is the operand. 

After you have entered the first instruction, you may 
tab into the Remark field. On a program as short as this 
one, however, you may choose to save time by omit- 
ting the remarks. Continue entering lines 002, 003, and 
004 in a similar fashion. 

Once you've entered part or all of the program into 
memory using the Add command, you can use the other 
editing commands. Each of these commands prompts 
you for a particular line number. E lets you Edit an 
already-existing line in memory. D allows you to Delete 
a line, and I lets you Insert a line. The L command lets 
you List up to 10 lines of a program to inspect what is 
in memory. If the program extends more than 10 lines 
beyond the beginning line number that you specify, you 
have the option to either continue listing more lines or 
quit and return to the command line. 

Labels As Labor Savers 

In line 005 (HERE JMP HERE), you encounter an impor- 
tant assembly-language tool— the "label." In the 
NanoAssembler. we define a label as a group of up to 
6 alpha-numeric characters, beginning with a letter- 
in our example, the word HERE. Assembler programs use 
labels in place of numeric quantities. In this case, HERE 
represents the address to be JuMPed 
to. One major advantage of labels is 
that you do not have to know the ac- 
tual numeric addresses used in a pro- 
gram. Instead, the assembler uses the 
labels to assign the correct address to 
a particular instruction for you. 

Before continuing, lets clear up an 
area that sometimes confuses a begin- 
ner at assembly language: the dif- 
ference between line numbers of a 
source file and addresses of an object 
file. Each line in a source file contains 
only one op-code. But when you 



CONTROL CAPSULE 



assemble the source file into object code, the op -code 
may require as many as three addresses (see Figure 1 
for the number of nibbles each instruction requires). 
Thus, a source file's line numbers and the actual ad- 
dresses of the object code almost always differ. When 
the Assembler prints out its listing, the addresses and 
codes are located on the line just below the source code, 
representing the order of events during assembly. 

By inspecting the two left-hand columns of Sample 
Program 1, you can see that the address to be JuMPed 
to is 6. You know this only because we have already 
assembled (or translated) the source code on the right 
into the object code on the left. If we hadn't provided 
the machine code, however, you would have to assem- 
ble all of the instructions to discover what address you 
wanted to JuMP to. The use of labels saves you from this 
tedious task and is one of the primary advantages of 
assemblers. 

When you finish entering line 005 and press [RETURN] 
or [ENTER), a prompt tells you to enter line 6. This pro- 
gram has no line 006, so press the [ESCAPE! key for your 
machine (see your Control Capsule), and the program 
returns you to the command line. Now you can use the 
List command to see if you have entered everything cor- 
rectly. If you find any errors, you can Edit the line or 
lines that they occur in. If you change a line, then decide 
that you don't want those changes, you can press the 
[ESCAPE] key instead of IRETURN] or [ENTER] to revert back 
to the original version of the line. This option is also 
available if you select Insert, but change your mind 
before finally entering the line. 

From Editor To Assembler 

After you are sure that you've correctly entered the 
program, save it to disk (or tape on Atari, C-64, or TI). 
To save your file, select option (2) Files. Then select the 
appropriate menu options, and enter the file name. If 
your operating system does not normally support ex- 
tensions to file names (all but Atari and IBM), the name 
must be at least two characters shorter than a normal 
legal file name. The program will automatically append 
a .S (_S on the TI), for Source, so that you can use the 
same name for both source and object files without any 
confusion. If you have a printer, you may also wish to 
get a hardcopy of your program. This is helpful when 
you are tracking down errors during assembly. To use 
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| -=^| 


NanoEdltor 




KEY 


FUNCTION 




ESC 


Escape 




Edit Mode: 






BACKSPACE 


Backspace 




CONTROL D 


Erase line 




TAB 


Tab. 




— 


Cursor left 




RETURN 


Cursor right 
Enter Line 
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SI 


NanoEdltor 




KEY 


FUNCTION 




ESC 


Escape 




Edit Mode: 






DELETE 


Backspace 




SHIFT DELETE 


Erase line 




TAB 


Tab 




CONTROL - 


Cursor left 




CONTROL - 


Cursor right 




RETURN 


Enter Line 







NanoEdltor 


KEY 


FUNCTION 


Fl 


Escape 


Edit Mode: 




DEL 


Backspace 


F3 


Erase line 


F5 


Tab 


CRSR - 


Cursor left 


CRSR - 


Cursor right 


RETURN 


Enter line 
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NanoEdltor 


KEY 


FUNCTION 


ESCAPE 


Escape 


Edit Mode: 




BACKSPACE Backspace 


DELETE 


Delete character 


TAB 


Tab 


— 


Cursor left. 


- 


Cursor right 


ENTER 


Enter line 
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-Jfy 




NanoEdtior 




KEY 


FUNCTION 




FTCN 9 


Escape 




Edit Mode: 






FCTN 1 


Delete 




FCTN 3 


Erase line 




FCTN 7 


Tab. 




FCTN S 


Cursor left 




FCTN 


Cursor right 




ENTER 


Enter line 
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the Print option, just select it from the main menu (3). 
After you save (and print) the source file, select the Exit 
option from the main menu. The program gives you a 
chance to change your mind before ending, so you don't 
need to worry about losing the program in memory due 
to an erroneous keypress. 

Now it is time to load and RUN the NanoAssembler. 
The program prompts you to loadtyour source file for 
assembly. As the program translates your source code 
into machine code, it lists the source file, the addresses, 
and object code to either the screen or a printer (if you 
have one). 

Passing Through 

The actual assembly of the program occurs in two 
steps, or "passes." Thus, the NanoAssembler is a "two- 
pass" assembler. The first pass does most of the work, 
determining the correct machine-language instructions 
and the instruction addresses. However, sorting out 
labels requires a second pass because, until it identifies 
all address labels, the program may not know the ex- 
act address of each instruction. 

Try assembling Sample Program 1. If you have 
entered it correctly, the NanoAssembler should output 
the assembled version, as shown in Figure 1, to the 
screen or printer. If you have made an error in entering 
the program into the NanoEditor* the NanoAssembler 
informs you of the line number in the source code that 
contains the error, and states the type of error. For ex- 
ample, if in line 1 you enter LDA #3 instead of LDA# 3, 
when you try to assemble the program the computer 
displays the error: ILLEGAL USE OF LABEL IN LINE 1 . Here. 
the computer interprets the code as a LoaD A addr in- 
struction (object code = 2), instead of a LoaD A im- 
mediate instruction (object code= 1). Then, when the 
computer evaluates the "label" #3, it finds that the label 
is illegal because it does not begin with a letter. 



Figure 1: Instruction Set 



Dec. Binary Nibbles Mnemonic 
per 
instr. 

%0000 1 ADD 



%Q001 
%0010 

%oon 

%0100 
%0101 
%0110 

%am 
%iooo 



Flags" Function 
affected 
C Z 

Y Y Add the contents of B register to 

the contents of A register— result In 

A. 
LDA* N Y Load A with number following In- 

struction. 
LDA addr N Y Load A with number at location 

specified by addr. 
STA addi N N Store the contents ol A at location 

^ specified by addr. 
TAB N fa Transfer contents of A to B 

TBA N Y Transfer contents of B to A. 

RRC Y Y Rotate A right one bit through 

carry, 
RLC Y Y Rotate A loft one bit through 

cany. 
AND Y Y Logically AND A and B-Result In 

A. 
OR Y Y Logically OR A and B— Result in A. 

XOR Y Y Logically XOR A and B-Result In 

A, 
BZ addi N N Branch to addr if Zero flag is set. 
BNZ addr N N Branch to addr if Zero flag is not 

set. 
N N Branch to addr 11 Carry flag is set. 
N N Branch to addr if Carry flag is not 

set. 

Branch to addi unconditionally. 

Use to specify a particular address 
(e.g.. specify starting address of 
program). 
EQU n/a Equate label with value— assigns 

the value to the right of the EQU 
statement to the label to the left, 
n/a n/a 1 DN n/a Define Nibble— assigns the value 

to the right of the DN statement to 
the label at the left. 

* Flags affected refers to whether or not the instruction has 
any effect on the flags in the status register. The C column 
stands for the Carry flag {did the operation result in a carry 
being generated?), and theZ stands for the Zero Hag (did the 
operation result in a zero?}. A Y appears in the column if the 
flag is affected by the instruction. An N indicates the flag is 
not changed by the instruction. 



9 %100l 

10 %1010 



11 %1011 

12 %noo 



13 %110i 3 BCSaddr 

14 %1110 3 BCCaddr 



15 %1111 

Assembler Diiectlves: 
n/a n/a ORG 



n/a n/a 



JMP addr N N 



After displaying the program, NanoAssembler 
prompts you to save the object file. The saved file is iden- 
tical in format to the ones you loaded and saved with 
the NanoProcessor last issue; that is, the file contains 
the contents of all addresses from through 255. To 
see that your program works properly, load and RUN the 
NanoProcessor. You can then load and run the program 
you've just created according to the instructions detail- 
ed in Vol. 5, No. 5. 

For a short program such as Sample Program 1 , this 
process may seem a bit time consuming. For longer and 
more complex programs, however, the ease of writing 
and debugging provided by an assembler more than 
makes up for the added steps. 

Assembler Directives 

Figure 1 displays the 16 instructions that we detail- 
ed in the NanoProcessor. You may specify any of these 
instructions when writing an assembly-language pro- 
gram with the NanoEditor. The NanoAssembler* in turn, 
converts these instructions into their machine codes. 
There are three additional commands, known as 
assembler directives, that the Assembler understands: 



Directive 


Purpose 


ORG 


Start object code here 


DN 


Define a nibble 


EQU 


Define a label 



The ORG command directs the NanoAssembler to 
assemble the program at a specified address between 

and 255. For an example of this instruction, see line 

1 of Sample Program 2. This program is a slightly 
modified version of Sample Program 2 that we presented 
in last issue's NanoProcessor. It performs a two nibble 
addition of numbers located at addresses 240 and 241 , 
placing the answer in addresses 248 and 249. The ORG 
statement makes the starting address %1010. 

The DN instruction allows you to include a particular 
value at any address. Just specify the address using the 
ORG directive, and then define the value to be placed 
at that address with the DN directive. Lines 22 through 
24 of Sample Program 2 define the two nibbles that the 
program adds. 





Figure 2 




Decimal 


Binary 


Hexadecimal 





%0000 


1? 


1 


%0001 


2 


%0010 


$2 


3 


%0011 


$3 


4 


%01O0 


$4 


5 


%0101 


$5 


6 


%0110 


$6 


7 


%0111 


$7 


8 


%1000 


$8 


9 


%1001 


$9 


10 


%1010 


$A 


11 


%1011 


$8 


12 


%1100 


$C 


13 


%1101 


$D 


14 


K1110 


$E 


15 


%1111 


$F 







Sample Program 1 


Addr 


Code 


Line 


Label 


Mnemonic 


Remark 






001 




LDAff 3 


:Get first number 





%0001 










1 


%0011 














002 




TAB 


;Move to B 


2 


%0100 














003 




LDAff 7 


;Get second number 


3 


%0001 










4 


%oiii 














004 




ADD 


^Figure sum 


5 


%0000 














005 


HERE 


JMP HERE 


Jump self to stop 


6 


%1111 










7 


%ono 










8 


%0000 
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The EQU command lets you identify any address with 
a particular label. Lines 2 through 6 of Sample Program 
2 use this directive. These statements make Sample Pro- 
gram 2 more readable by assigning descriptive labels 
to the 5 data addresses: NIB1 and NIB2 for the two 
numbers to be added; LON1B and HINIB for the low and 
high nibbles of the answer; and OUT for the OUT light, 
(See last issue's NanoProcessor for a complete explana- 
tion of how Program 2 uses these 4 locations.) 

The other change to Program 2 in this issue is in the 
use of the OUT light located at the upper-left of the 
NanoProcessor screen. When you assemble Sample Pro- 
gram 2 and run it, you will find that the OUT light is 
off when the program begins, but it turns on when the 
program is complete. Thus, you do not need to know 
what address the program will end on. Instead, the OUT 
light signals that the program is finished. 

Sample Program 3 accesses the NanoProcessor' s 
"sound chip." Any time you store a number at either 
location 254 or 255, the NanoProcessor responds with 
a tone. With 16 different values possible at each of these 
locations, you can make a total of 32 different tones. 
Sample Program 3 plays a C scale. 

We hope that you have found these Nano programs 
instructive and enjoyable. With what you have learned, 
you should be able to create your own "machine- 
language" routines. Feel free to let us know in "Letters 
to the Editor" of any programs you create, so we may 
share them with our readers. 



HCM Glossary Terms: assembler, label, object code, op-code, operand, 
pass, source code. 

For your type-in listings, see HCM PROGRAM LISTING CONTENTS. 
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Sample Program 2 


Addr 


Code 


Line 
001 


Label 


Mnemonic 
ORG 10 


Remark 






002 


NIB1 


EQU SFO 








003 


NIB2 


EQU $F1 








004 


LONIB 


EQU SFS 








005 


HINIB 


EQU SFS 








006 


OUT 


EQU SFD 








007 




LDA#0 


;Turn OUT light off 


10 


%OOQ1 










11 


%oooo 


008 




STA OUT 




12 


%0011 










13 


%1101 










14 


%1111 














009 




LDA NIB1 


;Get first number 


15 


%0010 










16 


*/e0O00 










17 


^1111 














010 




TAB 


;Move to B 


IS 


%0100 














Oil 




LDA NIB2 


;Get second number 


19 


%0010 










20 


%0001 










21 


%1111 














012 




A00 


:Figure sum 


22 


<&0000 














013 




STA LONIB 


;Low to memory 


23 


%0011 










24 


%1000 










25 


Hllll 














014 




BCC MB 


;0ne nibble answer 


26 


%1110 










27 


%0010 










28 


%ooio 


015 




LDA* 1 




29 


%oom 










30 


H0001 














016 




JMP STHI 


:AII done 


31 


'oil 11 










32 


H010Q 










33 


SOCIO 














017 


NIB 


LDA#0 


;Zero A 


34 


S0001 










35 


%oooo 














018 


STH1 


STA HINIB 


;Hfgh to memory 


36 


%oon 










37 


H10O1 










38 


%1111 














019 




LDA0 ON 


;Set OUT light 


39 


%0O01 










40 


%0001 


020 




STA OUT 




41 


H0011 










42 


%1101 










43 


%lill 














021 


HERE 


JMP HERE 


:Jump self to end 


44 


f ollll 










45 


%iioo 










46 


S0010 


022 
023 
024 




ORG SFO 
DN SA 
DN SC 





Three Number Systems Supported 

Machine language on the NanoProcessor can be 
entered only In bfnary. The NanoAssembfer, however, 
understands decimal and hexadecimal in addition to 
binary. Last issue we explained how to convert between 
decimal and binary— this issue we introduce you to 
hexadecimal. 

As we explained in the previous issue, decimal is a base 
10 system. It uses ten digits |0 through 9) to represent 
numbers. Similarly, binary '^ a base 2 system and uses two 
digits (0 and I J. Hexadecimal is a base 1 6 number system 
and uses 1 6 different digits— through 9 plus the letters 
A through F. (See Figure 2 for a conversion chart.) As the 
conversion chart shows, we can express the number 1 1 
decimal as either the binary number % 1 01 or the hex- 
adecimal number $B. [Note that the % symbol denotes 
a binary number, and the S symbol a hexadecimal 
number.) 

To convert a two-digit hexadecimal number (say SC8) 
to decimal you simply find the decimal equivalent of the 
left-most digit (i.e., SC = 1 2), and multiply it by 1 6. Then 
simply Bdct the decimal equivalent of the right-most digit 
(12*16 + 8 = 200). Hexadecimal is a particularly useful 
system in assembly language because it can express any 
nibble as a single character or any byte as two characters. 







Sample Program 3 


Addr 


Code 


Lino 


Label 


Mnemonic Remark 






001 


SOUND 


EQU 254 






002 




LDA# 2 





%0001 








1 


%0010 


003 




TAB 


2 


%0100 


004 




AND 


3 


%1000 


005 




RRC 


4 


%0110 


006 




STA SOUND 


5 


%00U 








6 


%1110 








7 


%11H 


007 




ADD 


8 


•/oOOOO 


008 




STA SOUND 


9 


%0Q11 








10 


%mo 








11 


%1111 


009 




ADD 


12 


%0000 


010 




STA SOUND 


13 


%0011 








14 


^1110 








15 


%1111 


on 




LDA# 6 


16 


%0001 








17 


%0110 


012 




STA SOUND 


IS 


%0011 








19 


%1110 








20 


% 1 1 1 1 


013 




ADD 


21 


%0Q00 


014 




STA SOUND 


22 


9(0011 








23 


%1U0 








24 


%1111 


015 




ADD 


25 


%0000 


016 




STA SOUND 


26 


%0Q11 








27 


%1110 








28 


Mill 


017 




ADD 


29 


%0000 


018 




STA SOUND 


30 


%0011 








31 


%1110 








32 


%1111 


019 




LDA# SD 


33 


a 0001 








34 


%1101 


020 




STA SOUND 


35 


%1101 








36 


%1110 








37 


%nii 












021 


HERE 


JMP HERE 


38 


% 1111 








39 


%0110 








40 


%0010 
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HCM Review criteria 

Each month, Home Computer Magazine (HCM) reviews products designed for the Apple II family. 
Atari 800 family and compatibles, Commodore 64, IBM PC and PCjr, and Texas Instruments 99/4A 
computers. HCM reviews take a detailed look at the quality, utility, and value of commercially 
available packages for these machines. Because our publishing charter forbids accepting outside 
advertising, we strive to make the scope and content of our review pages shine with a unique 
blend of humanistic frankness and objectivity. 

Not only will you find all relevant information for making a wise purchase decision, but in some 
special cases we also provide nuggets of compu-prestidigitation.* For example, we frequently include 
essential documentation not furnished by the manufacturer. Additionally, each issue of HCM tries to 
review at least one outstanding product— a "Diamond in the Rough"— which, because of company 
size, marketing clout, or for some other reason, has not received the attention it deserves. 



At the beginning of each review, a review-at-a-glanee box provides the 

user with an instant assessment of the product. Each item will be 

evaluated, where relevant, with the criteria below. 



HCM Review \ W \MM ,EC.Effi $.. 




Name: 

Program Type: 
Machine: 



Distributor: 
Price: 



Old Art 

Recycled Graphics 

Apple II family, 

Atari 800XL, C-64 

IBM PC & PCjr. TI-99/4A 

Hit 'n' RUN Software, Inc. 

$99,99 (or trade for 

'72 Pinto) 

System Requirements: 

Disk Drive, Joystick. Trash Can optional 

Poor Fair Good Excellent 

Performance: ■■■■■■■■■■■I 

Engrossment: 

Documentation: 



Products may also be evaluated In the following areas: 



* Flexibility— 

Can the product be 
adapted to the specilic 
needs of the users? 

* Cost/Benefit— 

Is the product worth the 
user's investment in 
time and money? 

* Necessity- 
Is the product a solution 
for which a problem 
already exists? 



* Originality- 
Is it unique in concept, 
or simply a "me too" 
product? 

* Longevity— 

The "Boredom Factor." 
Does the program 
sustain interest? 

* Rewards- 
Are the audio-visual 
rewards motivating and 
appropriate? 



* Concept Presentation— 

Are the concepts 
presented clearly, 
logically, and in depth? 

• Special Effects- 
How does quality of 
sound and visual effects 
rate? Do they enhance 
or detract from the 
product or learning 
process? 



* Performance— 

How well the product performs as 
intended \ how well it takes advantage 
of a specific machine's capabilities % 
how well it responds to the user's 
commands t how effectively the 
graphics, sound effects, music, or 
speech are integrated with the software. 

* Engrossment— 

Whether the game or activity has that 
intangible quality that holds players on 
the edge of their seats while the hours 
tick by unnoticed. 

OK 

* Ease of Use— 

The degree to which a user can interact 
with the product without outside help; 
the ease and effectiveness of error- 
handling features; whether the actual 
reading level of the activity is 
appropriate for the suggested audience. 
OR 

* Ease of Set-up- 
How well the product design facilitates 
easy installation. 

* Documentation— 

The quality of the printed matter that 
comes with the product; whether the 
instructions are clear and 
comprehensive; whether the machine 
configuration requirements are spelled 
out. Information such as how to load a 
program, use the keyboard, and restart 
an activity contributes to the 
documentation rating, as do tips on 
performance peculiarities. 



Attention Software Authors & Peripheral Inventors: 

* WANT TO BE DISCOVERED? * 

Home Computer Magazine Wants To Give You A Chance! 

We are looking for home computer products that have not allowed you to capture major media attention— we 

not received the attention they deserve. Each month, we want to see it. We will consider reviewing any product 

will be singling out one such package for special review. that meets our high standards. 

If you have a unique commercial product of exceptional We are an Equal Opportunity Reviewer! 
quality— but your advertising and promotion budget has 



In order to qualify for possible review, your product must; 

1. Currently be available for purchase to readers 
of this magazine, 

2. Make a unique and important contribution to 
the home computer industry. 

3. Be of outstanding merit, quality, and value. 

4. Be consistent with the type of machines and 
products we normally cover. 



If you feel that your product qualifies, mail it to: 

Home Computer Magazine 

Attn: Editorial Submissions 

1500 Valley River Drive, Suite 250 

Eugene. OR. 97401 
We reserve the right not to reply to each inquiry, so 
please do not contact us except to request return of your 
product. If you want your product to be returned, please 
include sufficient return postage. 



* Compu-pres tidigi tatlon 



( k6 m'* pu •pres'»teh«di •jeh«ta'»shun) — n 1. The magical 
quality of unexpected comprehension that results from presenting technical 
information about computers in a lively, entertaining. visuaJly attractive and 
easy-to-understand format. 2, The magical tricks that make a" computer sing, 
dance, and do all sorts of wonderfully useful things. 



JUNIOR ENHANCEMENTS 

by Laile L. Di Silvestro 

HCM StalT 

Do you yearn for the memory of an elephant, the speed of a mouse? 
Perhaps these two PCjr peripherals can help. 



How many IBM PCjr owners haven't yearned for 
the expansive memory of Junior's larger 
brothers? For a second disk drive? How many 
haven't sighed when passing up memory-hungry pro- 
grams such as Volkswriter, Framework, and Multiplan? 
Well, the market bears good news: With the help of a 
peripheral or two, Junior can grow. 

Several memory expansion systems are available. 
providing the PCjr with additional memory ranging 
from 64K to 384K. Most systems include one or more 
extra features that the Junior normally lacks, such as 
a second disk drive, a parallel port, and a clock/calen- 
dar. Such systems promise to provide the speed and 
flexibility associated with the IBM PC. 

In previous issues, we reviewed three expansion 
systems: the Quadjr Expansion Chassis, the Legacy II f 
and theTecmarjrCaptain. [See "Romancing the PCjr: 
A Review of the Quadjr Expansion Chassis" in Vol.5, 
No.4, "Legacy II for the PCjr" in Vol.5, No.2, and "Jr. 
Addition: A Review of the Tec mar jrCap tain Peripheral" 
in Vol.4, No.4— Ed.] In this issue we review two more— 
the Microsoft Booster and the IBM PCjr Memory Expan- 
sion Attachment, Both systems provide an additional 
128K. RAM drive, and software utilities intended to 
satisfy the memory -starved PCjr owner's every craving. 
Because the documentation that accompanies both of 
these systems lacks essential information, in this review 
we pass some of the missing pieces on to you. 

Moving Memory 

Junior presents a challenge to those who would ex- 
pand its memory. The difficulty lies in Junior's unique 
memory allocation. Unlike the IBM PC, which has 
dedicated Random Access Memory (RAM) for video 
memory (located at $68000 in high memory address 
space— the dollar sign denotes hexadecimal), Junior's 
video buffer is located in low memory address space in 
the middle of system RAM. When powering up, the IBM 
Expanded PCjr expects to find this video buffer in the 
same place each time: the last 16K (locations $16580 
through $1F400) of its 128K RAM. Once Junior's Disk 
Operating System (DOS) locates the video buffer, it 
ceases its search for memory. Therefore, it cannot ac- 



cess any memory added beyond this video buffer. 

Memory expansion systems overcome this problem 
by using software to move the video buffer into the DOS 
section of memory. As a result, the memory available 
for application programs opens up, thereby becoming 
contiguous with the additional memory. The program 
responsible for this rearrangement is activated through 
a CONFIG.SYS file— a file that runs as DOS loads into 
memory, reconfiguring the way in which Junior views 
its memory. 

You can also use the CONFIG.SYS file to activate a 
simulated disk drive known as RAM drive. You can do 
almost everything with RAM drive that you would do 
with your normal disk drive: copy files into the drive, 
save files, and load files into system memory or onto 
the screen. Because the methods involved in creating 
a RAM drive differ with each product, we will discuss 
them in detail in separate sections below. 

The main advantage of RAM drive is its operating 
speed. Because they are not hampered by mechanical 
devices or serial processing, most RAM drives operate 
much faster than conventional disk drives. The major 
disadvantage of RAM drive is that a system reboot or 
a power cutoff results in complete data loss. 

I. The Microsoft Booster 

Microsoft's PCjr Booster is a 1.5 watt circuit module 
that provides your Junior with an additional 128K. It 
is equipped with a port intended for use with Microsoft's 
mouse, [Watch for a review of this product in our "ro- 
dent round-up" next issue— Ed.) Do you usually skip 
entering the date and time when you power up Junior? 
The Microsoft Booster provides a battery-powered clock 
that will take care of the task for you. The package in- 
cludes the Microsoft Mouse, software, the Installation 
and Operation Manual, a Microsoft Mouse Menu 
manual, and a 4.5 Volt battery. 

Installation of the circuit module couldn't be simpler. 
You have only to pop the side cover off of the I/O expan- 
sion port, press the module into place, attach it with the 
provided screws, and re -install the side cover. To in- 
crease Junior's memory up to 5 12K, you can piggy back 
additional modules onto the original Booster, using the 




w 



Name: 
Product Type: 

Machines: 
Distributor: 



Performance: 
Ease of Use: 

Ease of Setup: 

Documentation: 

Cost/Benefit: 



Microsoft Booster 

Hardware/software memory expansion 

IBM PCjr 

Microsoft Corporation 

10700 Northrup Way 

Beltvue, WA 99004 

(206) 828-8080 

Poor Fair Good Excellent 
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same installation procedure. Due to Junior's limited 
power supply, however, you must install the IBM Power 
Expansion Attachment to accomodate the extra power 
needs of additional modules. 

Next, you must set the memory address switches. 
These three switches (located on the side of the module) 
serve to inform Junior of the location of the additional 
memory. 

With the Booster installed, all that remains is to recon- 
figure the way that Junior views its memory, so that 
it can access the additional memory. Microsoft software 
provides CONFIG.SYS files that do the job. CONHG1 .SYS and 
CONFIG2.SYS are sample files that you may use for dif- 
ferent applications: The first provides the maximum 
amount of application-usable memory and is best suited 
for programs that require large amounts of memory; the 
second creates a RAM drive. Both files contain the 
following command lines, which set up the mouse and 
clock functions; 

DEVICE a CLOCK. SYS 
DEVICE = MOUSE.SYS 

In addition, CONFIG2.SYS contains a line that establishes 
the memory configuration: DEVICE = MEMORY.SYS. This 
must be the first command in CONFIG.SYS. 
You can pass three pa- 



which Junior stores its video buffer sometimes ties up 
additional blocks of memory. To determine the exact 
size of RAM drive, use the CHKDSK.COM program 
(described in the IBM DOS manual). 

The Installation and Operation Manual seems to be 
aimed at the more experienced computer user; well- 
written notes and charts convey side information that 
can both benefit and interest those that want to know 
the reason behind the procedures. The manual's main 
content, however, is scanty and imprecise. For example, 
to instruct you on the setting of switches, the documen- 
tation directs you to a misleading illustration of a dif- 
ferent type of switch than the module is actually 
equipped with. To determine the correct switch settings, 
you must ignore the text and refer to a chart that was 
intended only for multiple-module installation. For a 
first-time user, such inconsistency is confusing. 

II. IBM Memory Expansion Attachment 

IBM's memory expansion system is quite similar to 
the Microsoft Booster: It provides an additional 128K 
of memory; it comes with a software disk to reconfigure 
Junior's memory; and it attaches to Junior's I/O expan- 
sion port. The IBM expansion differs in that it offers no 
extra features such as mouse, clock, or device port. In 

addition, the IBM expan- 



rameters to MEMORY. SYS via 
the CONFIG.SYS file. Is-.nn 
establishes the size of RAM 
drive {nn = a number be- 
tween 1 and 80 represent- 
ing 6K to 9 IK); Id:nn deter- 
mines the number of files 
that you can store in RAM 
drive (nn = a number be- 
tween 4 and 64); fv-jm specifies the size of the video buf- 
fer (nn = 2K to 96K in 2K increments). The easiest way 
to set these parameters is to use the DOS EDUN.COM pro- 
gram to edit CONFIG.SYS to alter the parameters passed 
to MEMORY.SYS. 

MEMORY.SYS stores RAM drive with DOS and the video 
buffer in Junior's internal memory, rather than in the 
additional memory. If you specify the maximum 
amount of memory (80), RAM drive receives the 
memory that is left over after DOS and the video buffer 
are installed. Therefore the maximum amount of 
memory RAM drive can hold is 9 IK. [Microsoft represen- 
tatives claim that a more recent version of the Booster 
software allows you to create a RAM drive with a capaci- 
ty of 256K minus room for DOS, the device driver, and 
the application— Ed.] It is impossible to specify the ex- 
act size of RAM drive. For one thing, the numbers ( 1 -80) 
that determine its size are relative figures that do not 
correspond to actual amounts of memory. The exact 
amount depends on how much memory DOS and the 
video buffer appropriate. In addition, the manner in 



"You could be pleasantly surprised 

at the enhanced abilities that these 

systems can provide— but only after 

considerable labor and tedious 

periods of trial and error, ff 



sion requires that you use 
it in conjunction with the 
IBM Power Expansion 
Attachment, 

The CONFIG.SYS file must 
contain FCJRMEM.COM to 
reconfigure memory prop- 
erly. FCJRMEM.COM relo- 
cates the video buffer and 
determines its size. If you include RAMDISK.COM, you 
also create a RAM drive. You can install these files by 
using the Automatic Installation program. This pro- 
gram is lengthy, however, and you may prefer to install 
the files yourself using the EDUN and COPY commands 
described in the IBM DOS manual. 

In terms of video buffer size, IBM's software does not 
allow you as much flexibility as Microsoft's— you have 
only three choices: 16K, 32K, and 96K, IBM offers con- 
siderable flexibility in RAM drive size, however. Because 
the IBM software does not consign RAM drive to system 
memory only, your sole limitation is the room that you 
must leave for DOS. the device driver, and the applica- 
tion. Unfortunately, it is difficult to determine exactly 
how large a RAM drive an application can tolerate, and 
the manual provides no help. Your only recourse is time- 
consuming experimentation. 

The manual constitutes the worst memory-expansion 
documentation we have encountered so far. What in- 
formation the manual contains is superfluous and 
redundant; and the most vital information is lacking. 



Name: 
Product Type: 

Machines: 
Distributor: 



Performance: 
Ease of Use: 
Ease of Setup: 

Documentation: 
Cost/Benefit: 



IBM Memory Expansion Attachment 

Hardware/software memory expansion 

IBM PCjr 

IBM Corporation 

900 Ktng St. 

Ryebrook, NY 10573 

(800) 426-2468 

Poor Fair Good Excellent 
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FIGURE 1 A comparison of three similar memory expansion systems. 
See HCM Vol.4, No. 4 for a review of the Tecmar JrCaptaln, 


PRODUCT 


RAM DISK CAPACITY 


CLOCK MOUSE PARALLEL REQUIREMENTS 
PORT PORT 


PRICE 


Microsoft 
Booster 
with mouse 


91K 


YES YES NO 


Expanded PCjr 
DOS 2.1 


$495 


IBM 

Memory 

Expansion 


256K minus 
room for 
device driver, 
DOS, applications 


NO MO NO 


Expanded PCjr 
Power Expansion 
DOS 2.1 


$325 plus 
$150 for 
Power 
Expansion 


Tecmar 
JrCaptaln 


256K minus 
room for 
device driver, 
DOS, applications 


YES NO YES 


Expanded PCjr 
DOS 2.1 


$395 



For example , the manual explains how to make a 
backup disk three times, yet it neglects to describe the 
procedure for accessing PGJRMEM.COM and RAMDISK.COM 
in order to specify the size of RAM drive and the video 
buffer. Fortunately, the software disk includes a 
PCJKMEM.DOC file that contains the Technical Reference 
Manual— a fact not revealed by the operating instruc- 
tions. This manual is somewhat better than the 
operating instructions and is absolutely essential if you 
want to to manipulate RAM drive. 

The Elusive RAM 

You could be pleasantly surprised at the enhanced 
abilities that the Microsoft and IBM memory expansion 
systems can give the PCjr— but only after you have 
undergone considerable labor and tedious periods of 
trial and error. 

The RAM drive potential to eliminate the hassle of a 
single drive, for example, is exciting. We imagined stor- 
ing entire applications in RAM drive so that the disk 
drive would be free for a data disk or a second systems 
disk. In this way, we could conceivably use programs 
such as Easywriter that require heavy use of two disks 
(see our review of this word-processor in HCM Vol.4, No. 
3) without the bother of constantly switching disks. To 
our disappointment, however, the RAM drive memory 
(9 IK with the Microsoft Booster; 256 minus room for 
DOS, the device driver, and any application with the 
IBM Memory Expansion) is rarely sufficient for an en- 
tire application— a debilitating limitation. Although pro- 
grammers might find the extra memory beneficial, we 
have found no PC software for which such a small 
amount of memory is adequate. (See the Counterpoint 
for a programmer's point of view.) In addition, some pro- 
grams are hard-coded to drives A and B, so they cannot 
access a third, RAM drive, 

Given RAM drive's limited capacity, it performs best 
if used for the temporary storage of data. Unfortunate- 
ly, you must copy all data onto a disk before you turn 
the power off or reboot— otherwise your work is for 
naught. Of course, some of the time that you save by 
using a RAM drive is consumed when you copy files in- 
to RAM drive and then onto a disk when you finish work- 
ing with your computer. But time factors and the fear 
of data loss put aside, using a RAM drive can be a delight. 
Transferring data from screen to RAM drive and back 
takes half the time it would if you used a traditional disk 
drive. And— especially if you find an application which 
fits into the simulated drive— the novelty and joy of not 
having to switch disks can mitigate any negative 
features. 

Considering the expense of beefing up Junior to 
match the PC's capabilities and the difficulties involved 
in memory expansion operation, it might be more 
worthwhile to simply buy the PC itself. Yet, if you 
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already own a Junior and want to use programs nor- 
mally restricted to the PC, memory expansion systems 
could be for you. 



■ur COUNTERPOINT fm 



For a programmer, beefing up the memory of a PCjr 
is an attractive prospect. Even though IBM BASIC is limited 
to 64K of RAM, a RAM drive can help shave down develop- 
ment time. By placing certain tried-and-true routines in 
RAM drive at the beginning of a session, you can access 
those files in the wink of an eye. Both the Microsoft Booster 
and the IBM Memory Attachment make RAM drive 
available. The disk-based documentation included with the 
IBM product is very informative; however, it is much easier 
to find the best memory configuration with the Microsoft 
unit— due to its slightly better documentation. With the 
IBM software, it Is difficult for the BASIC programmer to 
determine the best location and size of the video buffer. 

i have to give the Microsoft Booster a slight edge as a 
programming tool, because its accompanying software in- 
cludes a file called JBAS3C.COM, which loads PCjr Cartridge 
BASIC into the memory expansion instead of into Junior's 
internal RAM. Our tests show that BASIC works perfectly 
with the Microsoft Booster and RUNs a good 20 percent 
faster than normal. Although IBM's memory expansion 
can theoretically give you a larger RAM drive than the 
Microsoft Booster, I found that trying to access the higher 
resolution screens (i.e., SCREEN 5) causes the IBM system 
to behave erratically, and even lock up—regardless of 
which parameters I pass to PCJRMEM.COM . 

—Roger Wood 



HCM Glossary terms: CONFIG.SYS, DOS, hard-code, hexadecimal, 
parameter passing, RAM, video buffer. 

HCM 



MOVING? 

Don't Miss Out On 
Any Issues Of 

HOMEfOMPUTBt 

Send us a Change-of- Address Card 
{available at any Post Office) 
6-8 weeks prior to the move. 
Be sure to include both the old & new address, plus the 
alphanumeric code above your name on the mailing label. 

Home Computer Magazine 




Please send this 
information to: 



P.O. Box 70288 
Eugene, OR 97401 



John Bulakowski's File Direc- 
tory is a single-purpose pro- 
gram, designed simply to store, 
access, and print mailing labels. 
Small, narrowly -foe used programs 
can, by their very simplicity, make 
specific tasks easier— eliminating 
unnecessary distractions. But, in its 
simplicity, can File Directory enable 
you to perform your mailroom 
chores with ease? 

File Directory requires a disk drive, 
Extended Basic, and 32K memory 
expansion, A single disk is capable 
of maintaining 6 files, each with up 
to 100 records. Each record consists 
of 4 fields: name; street address: city, 
state, and zip code; and telephone 
number. 

Entering Records 

File Directory boots automatical- 
ly when you select the Extended 
BASIC option. Once you select a file 
to work on, you can create a new 
record or change existing records. To 
create a new record, enter all of the 
data (name, address, etc.) into the 4 
fields. The program automatically 
saves the information for you when 
you exit the program or begin work- 
ing on another record. The program 
can also list all of a file's records— or 
just the names— either to the screen 
or to a printer. 

File Directory lets you alter 
selected portions of y our records. Us- 
ing the [FCTN D) or [FCTN s| options, 
you can change a single word or let- 
ter without altering any other part of 
the record. Unfortunately, the first 
time you try to delete an entire 
record, you may experience some 
difficulty because there is a 
discrepancy between the instruc- 
tions in the documentation and the 
prompt on screen. The on-screen 
prompt directs you to DELETE RECORD 
WITH ERASE. The documentation 
reads "If you want to delete this 
record, enter FCTN 1 (DEL) and input 
ENTER." This is an obvious error. You 
can delete the record using [FCTN 1], 
but to do so, you must hold the key 
down until it deletes all of the letters 
in the top line of the first field, then 
press [ENTER]. On the other hand, the 
erase function on the TI-99/4A— 
[FCTN 3]— deletes files immediately 
and with ease. 

This error detracts from the overall 
quality of the documentation, which, 
though extensive, is sometimes 
poorly-worded and often confusing. 

Printing Possibilities 

File Directory prints labels and 
envelopes to specific preset tab loca- 
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File Directory 
Utility 
TI-99/4A 
John Bulakowskl 
162 Lorann Drive 
Naugatuck, CT 06770 
$29.95 
System Requirements: 

32K memory expansion, 

disk drive 

Poor Fair Good Excellent 



Name: 

Program Type: 
Machines: 
Distributor: 



Price: 



Performance: 
Ease of Use: 
Documentation: 
Cost'Benefit: 



FILE DIRECTORY I 

A Review by Steve Nelson 

HCM StalT 

This program won't turn your house into a post 

office, but it could make your monthly mailing 

chores a little hit easier. 



tions, although you can manipulate 
them if you need to. File Directory is 
written for use with a parallel printer. 
But if you are using a serial printer, 
the documentation provides ins true- 
tions on editing the program to allow 
you to use it. The program works 
with any printer that is compatible 
with the TI-99/4A computer and that 
can recognize the programs im- 
bedded commands. 

The program contains two print- 
ing options: Exception and Selection. 
Printing by Exception allows you to 
receive a printout in three possible 
typestyles: correspondence quality, 
standard, or expanded. Corres- 
pondence quality is crisper than 
standard quality, and expanded is a 
blown-up version of the typestyle 
used with correspondence quality. In 
the Exception mode, File Directory 
prints all files that you do not "ex- 
cept." After you select the option, the 
program prompts you for deletions. 
Use the (FCTN 3] option to delete the 
records that you don't want printed, 
and select a typestyle. The program 
then prints out all but the records 
you have excepted, without deleting 
any records from disk. You can print 
an entire file simply by making no 
"exceptions." 

The Selection option offers you 
only two typestyles: correspondence 
quality and standard. The program 
prompts you for two record 
numbers, then prints the records 
you specify. Each time it completes 



printing, the program prompts you 
for two more numbers and repeats 
the procedure until you finish. Un- 
fortunately, this printing method has 
the unnecessary drawback of tying 
you to the keyboard. 

You can find phone numbers with 
ease, using the phone-number op- 
tion. Enter the name (or partial 
name) of the person whose phone 
number you want, and File Directory 
searches through the records and 
prints the number or displays it on 
the screen. 

Finally, File Directory has the han- 
dy feature of sorting your records 
alphabetically by last name. The pro- 
gram sorts by looking for the space 
before the last name in each record. 
This means that if you enter a name 
like De Silva and leave a space before 
Silva, the program sorts Silva, not De 
Silva. The sorting process is also 
somewhat slow, to say the least- 
taking about 30 minutes for 100 
records! 

Considering File Directory's poor 
documentation and extrememly 
slow response time, many TI-99/4A 
owners might prefer their old 
address-filing method— scratching 
and erasing in an old, worn-out ad- 
dress book. But for those of you with 
more than a little time and patience 
to spare. File Directory is a safe, tidy 
way to organize and print all of your 
important addresses. 

HCM 
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Some of Grandma's best recipes contain very few 
ingredients. She always says that the simplest 
things in life are sometimes the best. 

Financial Cookbook, a straight-forward money 
manager from Electronic Arts, was built on the same 
premise. The program offers 32 recipes that answer a 
myriad of such financial questions as: Can I afford to 
buy a new car? Should I refinance my mortgage? Is an 
IRA the best way for me to save money for retirement? 

You can't answer these questions, however, without 
looking at rates for taxes, interest, and inflation. And 
if you're like me, these concepts seem much more 
complicated than one of Grandma's recipes. But Finan- 
cial Cookbook makes them easy to understand and 
takes your mind off the calculations so you can concen- 
trate on the results. 

The Cookbook" s recipes can cure you of "number 
phobia, ' ' while making you more confident about your 
financial situation. The pro- ^ _ 
gram lists the ingredients- 
all you have to do is watch 
them cook. 

Financial Cookbook is ex- 
tremely easy to set up and 
can be used with the Apple 
II familv. Macintosh, Com- 



'T/ie Cookbook's recipes can 

cure you of 'number phobia, ' 

while making you more confident 

about your financial situation." 



modore 64, IBM. and Atari computers. Within seconds, 
the program loads, and the Index of recipes appears on 
the screen. (The Commodore version is the exception 
here, taking over three minutes to load— a function of 
the slow Commodore disk drive.) 

Financial Entrees 

Using Financial Cookbook is a breeze— nothing like 
trying to steal Grandma's secret for apple pie. You have 
a choice of 32 very accessible and easy-to-understand 
recipes. They help you discover the "ins and outs" of 
interest rates, mortgages, financing, refinancing, life in- 
surance, and much more. 

Press only one key, and the list of the 32 formulas 
scrolls down the screen. Simply place the cursor on the 
recipe you want to use, press one more key, and you're 
ready to start plugging in numbers. 

Let's say you want to know how much money you'll 
need to deposit in your savings account each month to 
purchase a new car. Select MONTHLY DEPOSIT FOR FUTURE 
PURCHASE in the index of recipes. When the recipe ap- 
pears, type in the appropriate numbers and tell the com- 
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Financial 
Cookbook 



A Review by Michael Hosmar 

HCM Staff 

Use these money-managing recipes to 
saute some tasty financial advice. 



puter to make the calculations. When the answers flash 
onto the screen, move the cursor down to scroll through 
the monthly and yearly figures. Try different inputs, and 
compare the results. 

One of the program's most useful functions- 
Profile— inserts specified values automatically 
whenever a recipe calls for them. In other words, if you 
want to hold your marginal tax rate constant, type it 
into the Profile function. The Cookbook then enters this 
figure into each recipe you use, until you quit the 
program. 

Better Than Betty Crocker 

The program's documentation includes more than 
just operating instructions. Financial Cookbook's con- 
servatively designed package also contains "The 
Manual"— a 32-page handbook that could double as an 
entry-level economics course. It contains everything you 
need to understand the results yielded by this decision- 
making tool. It also explains a little bit about how each 
recipe was formulated— something not found even in 
the best of Betty Crocker's cookbooks. 
_ _ ,^^^^^^^^^^_ The Manual's reference- 
book format makes multiple 
references easy — each recipe 
is assigned a number that 
correlates with a number on 
the screen. And its 5-page 
Glossary concisely defines 
terminology that might be 



unfamiliar to inexperienced financial chefs. 

The Manual's main purpose, however, is to answer 
questions left unexplained by the operating instruc- 
tions. Therefore the booklet contains short explanations 
of each recipe ingredient, such as capital gains rate, 
marginal tax rate, and pre-tax gain. It also gives you 
easy-to-understand formulas that you can use to 
calculate these rates and interprets each result that the 
computer calculates. 

Cookbook Longevity and Flexibility 

Grandma's cooking doesn't always please everyone 
in the family. Similarly, Financial Cookbook might not 
fit into everyone's software kitchen. In fact, some users 
might think the program is too rigid and limiting. Here's 
one example: In recipe number 3 1 —BUYING YOUR CAR— 
there's no way to customize the time inputs for your 
own needs. The recipe asks how many "years" you plan 
to keep the car before reselling. But what if you plan 
to sell it in eight months? Six months? Or in some 
special cases, only a couple of months? The program 
won't allow those inputs. 



Most Financial Cookbook recipes don't need this 
specificity of time. Savings accounts and IRAs, for ex- 
ample, don't have much value if they last only a few 
months. But recipes that involve short-term in- 
vestments would contain more utility with this added 
time dimension. 

Another less obvious problem is that you might oc- 
casionally enter numbers that the program can't sen- 
sibly use. When that happens, a disgruntling message 
appears on the screen— SORRY, CANT HANDLE THOSE IN- 
PUTS. Your first response will probably be, "Why not!" 
The Cookbook designers must have overlooked an 
answer to this question. No prompts flash onto the 
screen to tell you that your monthly payment input is 
too low or that you forgot to enter your marginal tax 
rate. The Manual is no help either. Its explanation of 
this message merely reiterates the message itself. 
Therefore, the program makes you hunt down input 
problems through trial and error. 

Low-Risk Investment 

Aside from these minor inconveniences, Financial 
Cookbook is a sound investment. All versions of the pro- 
gram perform perfectly. Financial Cookbook on the 
Macintosh is a real treat. The window format and mouse 
capabilities make entering information a snap. The Mac 
also lets you simultaneously display a number of results 
for easy comparison. 

Money-management programs are by no means 
"something new," but Financial Cookbook seems to 
have qualities the others don't. It has found an 
unoccupied niche in the world of financial decision- 
making tools. 

The program offers more options and answers more 
questions than most of its competitors. Whereas $200 
programs like Managing Your Money by Andrew Tobias 
focus on the intricacies of tax planning, life insurance, 
and personal budgets, the $40 Financial Cookbook gives 
concrete answers to questions people ask every day: Can 
I buy a new car? Can we afford our dream home? How 
can I best save for the future? 

This combined calculator and reference source, 
however, is by no measure a substitute for your profes- 
sional advisor. Nevertheless, if you're unfamiliar with 
the way money works, it might help you to get your feet 
wet in the financial world. It also alerts you to many op- 
tions available for financial Investment, so you can ask 
the right questions next time you meet with your finan- 
cial advisor. 

So if you're planning to cook something up in the 
financial world, you might look up the recipes in the 
Financial Cookbook, 
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Name: 




Financial Cookbook 




Program Type: 


Financial decision maker 




Machines: 


Apple 11, II + , He, lie. Macintosh, IBM 
PC, PCjr, Commodore 64, Atari 800, 
800XL, and 130XE 




Distributor: 


Electronic Arts 
2755 Campus Dr. 
San Mateo, CA 94403 

(415J 571-7171 




Price: 


$40 




System Requirements: 


Disk drive and 48K 




Performance: 

Cost/Benefit: 
Ease of Use: 


Poor Fair Good Excellent 
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Move the cursor down the screen until you find 
the recipe you want to use. 
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When the recipe appears on the screen, 
enter information pertaining to your own finances. 



w COUNTERPOINT -w 



The product's title— Financial Cookbook— implies that 
the software contains a veritable financial "stew" of in- 
formation. But in reality, the separate programs merely 
comprise investment and IRA calculations, with a couple 
of home and auto comparisons thrown In for spice. It looks 
as if the Cookbook designers began with retirement 
analysis, and then loaded the disk until it was full. 
Moreover, programs similar to some of these "filler" recipes 
are readily available in other software packages and 
calculator resources. Financial Cookbook would be bet- 
ter published in volumes— each volume could cover the 
individual topics more thoroughly. 

—Bob Karau 
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Move the cursor to the bottom of the screen 
to scroll through the various calculations 
(e.g., present loan and new loan figures). 
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This screen from the Hydrologic Cycle's Human Impact Tutorial shows 
you the aqueduct system supplying water to Los Angeles, 



This screen from Moisture in the Atmosphere 's Clouds and Precipita* 
don Tutorial depicts what causes a weather front. 



Earth Science series 

A Review by Steve Nelson 

HCM Staff 

Educators and computers team up to help us study our physical environment 

. . .but is it an effective way to learn? 



Do you know how raindrops form, or how wells 
and underground springs get their water? Have 
you ever wondered how a cloud produces snow? 
With over 70% of the Earth's surface under water, what 
keeps the rest afloat? If you've ever puzzled over these 
things, then IBM's Earth Science Series is bound to In- 
terest you, 

The Earth Science Series comes in 4 packages, with 
a fifth package in the works, The programs have ex- 
cellent graphics and feature an easy-to-use question- 
and-answer format. Each program is independent of the 
others and addresses a specific aspect of the physical 
environment, Here are brief descriptions of the 
programs; 

Hydrologic Cycle— How the sun regulates the cy- 
cle of water from the earth to the sky and back to the 
earth again; the atmosphere, the lithosphere, the 
hydrosphere, the biosphere, and how they interrelate 
within the hydrologic cycle, 
Ground Water— The water beneath the surface of 
the earth and its importance to man and the environ- 
ment as a source of fresh water; water tables, rock 
porosity, aquiflers, and precipitation. 
Moisture in the Atmosphere— The relationships 
between air temperature, heat, humidity, clouds, rain, 
and fog. 

Surface Water— Lakes, streams, rivers, and how 
they are created; surface runoff, soil erosion, and the 
Impact of human habitation and farming on the 
environment. 

You must make a backup diskette before running 
each program, Once you do this, you are ready to begin 
the study session. Each program is broken down Into 
4 sections: the Tutorial, Human Impact, the True/False 
Quiz, and the Matching Quiz. The Tutorial and Human 
Impact sections are divided into subsections, each deal- 
ing with a particular aspect of the subject. You can select 
any section by pressing the appropriate key. If, while 
running the program, you decide that you need to 
review a section again to better understand a particular 
detail, you can easily move between screens or restart 
the section. 
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Question ft Answer 

Each interactive tutorial poses several types of ques- 
tions designed not only to determine whether you know 
the correct answer, but also to lead the discussion for- 
ward. For example, the program may ask you "thought 
questions," which you must reason out, even if the pro- 
gram has not yet covered all the pertinent information. 
Review questions test how well you understand the dif- 
ferent concepts that the program addresses. Other ques- 
tions may involve analysis of diagrams and charts or 
may require you to perform a simple calculation, 

A typical section consists of text accompanied by 
visuals and animation, In the Ground Water tutorial, 
for example, you first receive a definition of ground 
water, and then you study a series of animated visuals 
demonstrating how ground water forms, what happens 
to it underground, what we use it for, and how we ex- 
tract it from soil 

The second section, Human Impact, discusses what 
effect man and civilization have on each element of the 
environment, In the Hydrologic Cycle, for example, you 
learn how a city the size of Los Angeles meets its con- 
siderable fresh water needs, and what this high demand 
for water can do to the environment surrounding the 
city, 

When you complete both sections, you can test 
yourself with either the Matching Quiz or the True/False 
Quiz, Both require you to answer 10 questions from the 
information in the tutorials. 

The Overall Effect 

Depending on how quickly you study, it should take 
30 minutes to an hour for you to work through each of 
the Earth Science Series packages. 

Documentation is quite good— the manual is concise 
and provides a set of supplemental questions as well 
as a glossary of terms used in the course, Each Earth 
Science program follows exactly the same format, so 
once you've learned how to run one program, you can 
easily run them all 

The Earth Science Series' colorful and, in some cases, 
animated graphics are quite helpful in introducing the 




This screen from Ground Water's Human Impact Tutorial shows how 
numerous water-pumping wells can make the ground water level drop. 



This screen from the Surface Water Tutorial depicts the program ask' 
Ing a question about stream channel characteristics, 



"Can this software actually help 

you learn a subject more effectively 

than you otherwise would using a 

textbook? In the case of the 

Earth Science Series, I think that 

the answer is positive. " 



information. The screens change quickly with no un- 
due delays in drawing the graphics. Each visual is ac- 
companied by explanatory text and usually a question. 
When you type In your answer, the program provides 
immediate feedback— a detailed explanation of the cor- 
rect answer— regardless of whether your answer was 
correct or incorrect. 

Sound effects are almost non-existent, and probably 
not necessary— although they would add to the enjoy- 
ment of the program. 

Teaching With Computers 

Inevitably, packages like the Earth Sciences Series 
bring up questions about the role of computers in educa- 
tion. For any educational program, the obvious ques- 
tion is: Can this software actually help you learn a sub- 
ject more effectively than you otherwise would using 
a textbook? In the case of the Earth Science Series, I 
think that the answer Is positive. Using these interac- 
tive programs, you can study at your own pace, go back 
over sections you did not understand, and test yourself, 
In addition, the subject has been culled down to just 
the essentials you need to know— nothing is left to 
distract you. 

I think the important thing to remember here, is that 
Earth Science Series and similar educational programs 
are mainly supplements to normal, human interactive 
education. There is much more to learning than Just 
memorizing a few terms and taking a quiz. 

Effective Study Aid 

When used as a study aid, the Earth Science Series 
probably does have a place in the classroom. A teacher 
or science department could combine the programs 
with a regular course of study, or keep them in a 
resource room or library, where students could review 
them for class assignments, 

The Earth Science Series is an excellent set of pro- 
grams that should make any science buffs wish list, 
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Name: 



Program Type: 

Machines; 

Distributor: 



Price: 

System Requirements: 

Engrossment: 
Ease of Use: 
Documentation: 
Cost/Benefit: 



Earth Science Series; Hydrologlc Cy- 
cle, Ground Water, Moisture In the At- 
mosphere, end Surface Water 
Educational 
IBM PC, PCjr 
IBM Corp. 
900 King Street 
Ryebrook, NY 10573 
$49 each 

128K, color/graphics monitor adapter 
Poor Fair Good Excellent 



but its high price and limited subject matter will most 
likely keep it out of the home education market. A price 
of $49 per title is a pretty heavy investment for a pro- 
gram that you can exhaust in a day or two, Nevertheless* 
as a study aid, these programs can help students learn 
about Earth's environment, while doubling as a friend- 
ly and useful method for bringing neophytes into the 
world of computers. 
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Can me old-fashfoned, but I still think the best way to 
learn \s simply by reading books. Granted, the Earth Science 
Series employs colorful animation to present some very 
useful Information, but It's only a fraction of the Informa- 
tion comprised In most textbooks. After a\\, you can finish 
each program In only 30 minutes— how much knowledge 
can you cram Into a half hour? Anyone "high school level 
and above" will surely stretch the entire series of programs 
to Its limits within a couple of days. I think most users will 
soon ask themselves the same question I asked myself after 
using the series: "What can i do with these programs now 
that I've learned everything they can teach me?" I've found 
a use for them— they're just the right size to fill up the 
empty spaces \n my book shelves at home. But, with the 
series selling at nearly fifty bucks per inch, Brftannlca \s 
cheaper. 

—Michael Hosmar 
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From our earliest beginnings, mankind has viewed 
the sky with fear, reverence, and speculation. Our 
predecessors regarded comets and eclipses as in- 
dications of disaster or divine wrath, while imagining 
the stars to be populated with fantastic beasts and 
mythical heroes. More careful study of these 
phenomena led to the development of astronomy— 
probably the first science. From the Stone Age to the 
Computer Age, astronomy has continuously evolved, 
and so has the the way in which we teach it. From lying 
in a field on a cold, clear night, to reclining in comfort- 
able planetarium seating, we have refined our methods 
of viewing the changing sky. Now we have "astro- 
nomical" software providing interac- 
tive resources for both education and 
recreation. Here we examine a few 
such programs: The Halley Project for 
the C-64 and Atari; Halley s Comet 
and Astronomy: Stars for All Seasons 
for the Apple II family; and Sky 
Traveler for the C-64. 

Learning Through Gaming 

The Halley Project is an educational 
game— with the emphasis firmly on 
game. The game is in the "Mission Im- 
possible 1 ' style, featuring sealed 
classified documents and a "mission 
briefing" on audio tape. Your assignment is to train for 
a secret project by flying a series of missions to planets 
and moons in the solar system, landing on each, and 
returning to the project base— Halley's Comet. When 
you complete all of the training missions, the program 
issues you a special I.D. code which, when registered 
with Mindscape Inc., gains you entrance to another 
game: Halley Project— the Ultimate Adventure. The 
missions are timed, with a list of suggested completion 
times to test yourself against. 

The Halley Project disregards most real-world con- 
siderations of space flight, such as fuel consumption, 
acceleration and deceleration times, orbital and gravita- 
tional requirements, and, above all, the light-speed bar- 
rier. The flight system is fairly simple, comprising a 
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DESTINATION: EARTH. 

Your approach to Earth brings you 

closer to completing the Halley Project 



REACHING 
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A Review of 4 Astronomy Programs 
by Scott Darroch 

If the star-filled sky already 

grips your fascination, these 

astronomical software packages 

may hold the key to understanding 

what's really out there. 



"radar" screen to locate the planets, a viewing screen 
to orient the ship toward the proper zodiac constella- 
tion, and a drive to propel and steer the ship. The pro- 
gram accompanies game play with sound effects, some 
of which are fairly annoying, but necessary because 
they provide some important signals. 

On the first mission, for example, you blast off from 
your base (Halley's Comet, of course), slow to a stop, 
and use the radarscope to determine your target's direc- 
tion and distance. Then, orienting your ship by the con- 
stellations, you accelerate toward your destination. Dur- 
ing acceleration, you are treated to a screeching, beep- 
ing chorus of noises until you reach the speed of light- 
then bells ring, lights flash, and hundreds of millions 
of kilometers slide beneath your bow. As you near your 
target, you must slip out of 
"hyperspace" and maneuver your 
craft around the planet until you 
locate a landing area. A flashing light 
and bell tone signal the landing 
beacon, but you can easily overlook 
these signals during a tense orbital 
session. 

Overall, we found this to be an en- 
joyable game that teaches a few basic 
astronomical concepts and presents 
enough challenge to prevent the 
premature onset of boredom. Al- 
though this program is more of a 
challenge to arcade gamers than it is 
a serious teaching tool, it does require you to recognize 
the zodiacal constellations and to think about relative 
distances and planetary positions. 

Teaching By Tutorial 

Two of the astronomy tutorial programs, Astronomy: 
Stars for All Seasons, and Halley f s Comet, are intended 
for the classroom. Both make effective use of the com- 
puter's graphics abilities, but fall far short of the mark 
as either course material or reference sources. In terms 
of the texts, which are concise and understandable, both 
programs are accessible to students at fifth-grade level 
or above. Unfortunately, for young minds hungry for 
knowledge, the content of these programs provides only 
a thin soup— meager and unsatisfying. 




NAME 

The Halley Project 

Hal ley's Comet 

Astronomy: Stars 
for All Seasons 

Sky Travel 


MACHINES 

Commodore 64, 
Atari 800 & 

compatible 

Apple II family 
Apple II family 
Commodore 64 

KEY: P = 1 


DISTRIBUTOR PRICE 

Mlndscape, Inc. $39.95 
344 Dundee Rd. 
Northbrook. IL 60062 

C.C. Publications, Inc. $39.95 
P.O. Box 23699 
Tlgard, OR 97223 

Educational Activities, Inc. $59.95 

P.O. Box 392 Freeport, NY 

11520 

Commodore Electronics, Ltd. $49.95 

1200 Wilson Dr. 

West Chester. PA 19380 

Performance E = Engrossment D 


SYSTEM REQUIREMENTS 
Disk drive, joy stick 

Disk drive 

Disk drive 

Disk drive, printer optional 

= Documentation CB = 
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Most disappointing is Astronomy from Educational 
Activities Inc., a fancy package concealing a nearly emp- 
ty box. The program documentation looks Impressive 
if you don't go beyond the contents page. Terms like 
"program objectives" and "teaching strategies" are 
liberally scattered throughout. Nevertheless, the total 
documentation extends to the scanty sum of 10 pages- 
Including operating instructions and 5 pages illustrating 
the program's screens. If the text falls to convince you 
that the computer is not necessary to present the course 
material, a brief glance at the program should. After pro- 
viding a few short and somewhat inaccurate explana- 
tions of basic astronomical terms and phenomena, 
Astronomy attempts to illustrate them with an extreme- 
ly limited planetarium set-up. This device gives you a 
view of the night sky for any given month at any loca- 
tion from to 90 degrees north latitude. Such niceties 
as longitude, year, day, and time of day are all neglected, 
so we must view the accuracy of the display with some 
suspicion. The planetarium is so constrained, It would 
be quite difficult to use as a teaching aid. 

Astronomy's lack of depth and adaptability, com- 
bined with the almost nonexistent text and high price 
($59.95) easily qualify it as the most 
worthless of the 4 programs we review 
here. 



dependency without missing any of the package's 
educational value. Topics include orbital shapes, loca- 
tions and periods, structure and evolution of comets, 
and the origin of meteors. The workbook is quite useful, 
mostly because its projects and questions complement, 
rather than duplicate, the material contained on the pro- 
gram disk. Charts come in a three-ring binder allowing 
easy reproduction for classroom use (where permission 
is given). This course's smooth flow of instruction pro- 
duces a coherent, accurate discussion of all the points 
that it covers. 

The program's major short-coming lies not in content 
or construction, but rather in overspecialization . As a 
course in astronomy, the program is a three-legged stool 
with only one leg in place. One missing leg is informa- 
tion about the historical development of astronomy— 
the other is the illustration of planetary relationships 
and conditions. The publishers could upgrade this pro- 
gram to a comprehensive basic course in astronomy by 
including Information on planetary motions, constella- 
tions, and the relationship of planets and their satellites. 
We hope to see such an addition to this informative and 
easy-to-use course. 
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Grabbing the Comet's Tall 

Halley 's Comet and the Universe of 
Meteors, Asteroids, and Lesser Com- 
ets from C.C. Publications is far more 
comprehensive than Astronomy and 
comes closer to executing its objec- 
tives and making full use of the com- 
puter's capabilities. In addition to the 
4 topics referred to in the title, this pro- 
gram comes with a workbook, 5 
charts for plotting orbits, and a course 
on telescopes. 

The program presents its tutorials in an illustrated 
lecture format, making good use of the Apple's graphic 
capabilities. The graphics are accurate and clear, il- 
lustrating each principle and condition with pleasing, 
easy-to-follow animation. Each tutorial includes several 
question and answer sessions. Correct answers result 
in an encouraging message to continue, whereas incor- 
rect responses prompt the computer to present the 
material relevant to that question, then return you to 
the question. A preview option allows teachers to review 
the program's contents without having to answer every 
question before proceeding through the course. 

The charts, workbook, and disk program together 
form a course that a student could easily pursue in- 
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Hop aboard Halley's Comet to 

discover space and explore the 

world of comets, meteors, telescopes, 

and our system '$ asteroid belt 



Hitting The Heights 

Of all the programs that we cover in 
this review, Sky Travel— A Window to 
the Galaxy from Commodore Educa- 
tional Software is the most com- 
prehensive and complete— by several 
orders of magnitude. Sky Travel is a 
basic planetarium that can provide 
you a view of the sky from any posi- 
tion on Earth, at any time of day or 
night, and for a period spanning 
20,000 years. Although it displays 
only a portion of the sky at a time, 
rather than the entire dome. Sky 
Travel allows you to look below the 
horizon and through Earth itself. No portion of the 
celestial sphere is hidden from the observer. 

Sky Travel is very user-friendly, possessing a 
multitude of useful, informative features. Operating in- 
structions are blue -sky clear, and the program's text- 
hook (not just a manual) covers both the principles and 
the history of astronomy. This textbook would form an 
excellent foundation for a middle or high school course 
in astronomy. It explores elements of celestial mapping, 
planetary motion, the seasons, precession of the Earth's 
axis, and other topics— following each discussion with 
instructions on setting up an example from the 
planetarium. It also evokes history in relation to such 
astronomical events as the appearance of Halley's 
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Comet shortly before William the Conqueror invaded 
England, the conjunction of planets setting the year 7 
B.C. as the probable birth date of Jesus, and various 
historically significant solar and lunar eclipses. 

Sky Travel provides numerous options that are sim- 
ple to operate and quite useful for teaching, studying, 
or simply star gazing* A Set mode allows you to establish 
any observing date within 10,000 years forward or back 
from our present time, You can specify an observing 
time to the nearest second. 

A Map mode allows you to shift your viewpoint to any 
position on Earth, This mode also displays a readout 
which locates your viewing position to the nearest sec- 
ond of latitude and longitude. 

Sky and Chart modes show a view of the sky at the 
time and location you specify. The Sky mode displays 
a 72 degree arc— the average range of human peripheral 
vision. Chart mode projects the same view, but includes 
lines of latitude and longitude and reverses the field so 
that black stars rest on a white background. This rever- 
sal is especially useful for printing star 
maps from Sky Travel's planetarium. 
With an Option function, you can add 
or delete such features as deep space 
objects, lines connecting stars in the 
constellations, symbols for planets, 
and the names of constellations. 

A Find function automatically 
locates the moon, sun, planets, 
Halley's Comet, or any of 88 constella- 
tions, then brings the object to the 
center of field. You may use the cur- 
sor to look around— directly overhead 
or down through the Earth itself. 




Words From Above 

Sky Travel's data bank contains In- 
formation on over 1200 objects and 
constellations. You can receive this In- 
formation by placing the cursor over 
any object on the screen and pressing 
the Information button. Command 
keys allow you to narrow the field of 
view from 72 degrees to 36, 18 , and 
9 degrees. The smaller vision fields 
produce an effect much like a low- 
power telescope. As in telescope 
astronomy; you must keep the object 
you are viewing centered as you in- 
crease magnification. A variable clock 
can run the planetarium forward or 
back from a given time at rates vary- 
ing from 1 :: 1 to 1 :: 64 (an hour in less 
than a minute). The accelerated mode allows rapid view- 
ing of eclipses, conjunctions, and transits, while the 
slower rate keeps the display updated throughout an 
evening's star gazing. 

The sky display is quite colorful and sharp, with the 
entire color scheme changing with the position of the 
sun. You can locate any object on the screen precisely 
by placing the cursor on the item and reading the 
Declination and Right Ascension or Elevation and 
Azimuth figures displayed in the data window on the 
side of the screen. 

Although Sky Travel is an exceptionally complete 
display planetarium and data source, it suffers— like all 
things created by human beings— from a few drawbacks 
and omissions. For one thing, the program is based on 



A screen from Astronomy: Stars for 

All Seasons depicting the night sky 

in October for latitude 75* in the 

Northern Hemisphere. 




To navigate the stars in Sky Travel, 

enter latitude, longitude, and time zone 

using the cursor keys or joystick. 



a star chart of 2000 A.D. Because several of the closer 
stars have large proper motions, their positions do not 
appear accurately for time periods outside the span 
1500 to 2500 A.D. These variations of position range 
from a few minutes to several degrees of arc. When you 
use the planetarium to view astronomical events that 
occurred before 1000 A.D., there may be time discrepan- 
cies of 0.5 to 2 hours. These are due to differences be- 
tween universal time (related to Earth's rotation) and 
ephemeris time (based on an atomic clock). Variations 
in Earth's rotation rate, arising from such random 
sources as tidal drag, formation of ice caps, and con- 
tinental drift, also preclude absolute accuracy. 

Perhaps the major problem with Sky Travel's fine 
system, however, is that it does not allow you to store 
several viewing screens for display. To change the 
planetarium's viewpoint you must switch from Sky 
mode to Map mode to set the location, then to Set mode 
to establish date and time. Although changing viewing 
screens takes only a minute or two, a preprogramed set 
of coordinates and times would be 
desirable in an instruction or lecture 
setting. 

In a truly needless attempt to make 
this fascinating program more attrac- 
tive to the young, Commodore has 
added sound and cursor options as 
well as a "needle in the haystack" type 
game. The cursor option causes the 
crosshair cursor to appear as an 
airplane in Map mode and a starship 
in the Sky mode. The sound feature 
adds sound effects to cursor motion. 
Totally undocumented, but reported- 
ly buried somewhere within Sky 
Travel's myriad images, are 1 1 "map 
tokens"— famous landmarks that you 
would see if looking at the proper por- 
tion of the horizon from a specific loca- 
tion at a specific time. Considering the 
amount of use these features are like- 
ly to see, the memory capacity might 
have been much better used to pro- 
vide the save and recall feature men- 
tioned above. 

Despite these few complaints, this 
program packs in many benefits at a 
relatively small cost. Ease of use, in- 
structive features, comprehensive 
data bank, and a sharp looking display 
make this a quality product for both 
class or home. It's too bad you can't 
take this little planetarium and project 
it on your ceiling— but, short of that, it's almost all you 
could ask for in an astronomy program. 

As a classroom aid, home planetarium, or observa- 
tional tool, Sky Travel truly lives up to its billing as a 
"window on the galaxy." For Commodore users, this 
is good news. Apple and Atari users may prefer to wait 
until the "stars are right" for their own truly celestial 
window. 

[Watch for reviews of astronomy tutorial programs 
for other computers in a future issue— Ed.] 

HCM Glossary terms: azimuth, conjunction, declination, precession, 
proper motion, right ascension, zodiac. 
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Name: 


Speed Reading 


Program Type: 


Utility 


Machines: 


TI-99/4A 


Distributor: 


Navaront Industries, Inc. 




510 Lawrence Expressway 




#180 




Sunnyvale, CA 94088 


Prlca: 


$29.95 


System Requirements: 32K memory expansion 




(Disk drive recommended) 




Poor Fair Good Excellent 


Performance: 
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Ease of Use: 
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Documentation: 
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Cost/Benefit: 





Speed reading— some people swear it works, others swear 

because it doesn't work for them. Either way, 

Navarone's reading course still needs more work. 



The last time I checked, the jury 
was still out, trying to decide 
If speed reading courses real- 
ly work. Some experts say they do, 
some say they don't, From my own 
experience with such courses, I think 
they can help, but I'm not sure how 
long the effects will last. It seems that 
once you attain a certain reading 
speed, you must continue to read at 
that speed on a regular basis. If you 
don't, your reading speed will slow- 
ly diminish to the level you started 
from. Be that as it may, it's up to you 
to decide if you want to spend $29.95 
to And out if Speed Reading works for 
you, 

Speed Reading by Navarone, is a 
cartridge-based reading course for 
the TI-99/4A, The program comes in 
two versions: one for adults and one 
for children. Except for differences in 
the skill level of the reading selec- 
tions, both versions are identical. 

Speed Reading is easy to use, The 
program simply highlights the por- 
tions of the reading material that you 
are to read. The highlighting moves 
along the text at the wpm (words per 
minute) pace you select, The screen 
defaults to a light blue, with the en- 
tire text faintly visible in the 
background, and the emphasized 
portion in white, You can adjust the 
screen colors to the combination that 
appears sharpest to you. 

According to the manual, there are 
three basic elements that determine 
your reading speed: eye move- 
ment—the rate at which you move 
your eyes from one group of letters 
to another; eye span— the number of 
letters you take in with each fixation, 
or pause; and "perception"— the 
duration of each fixation. Speed 
Reading offers three exercises 
designed to enhance your abilites in 
these areas, 



Exercise For The Eyes 

The first exercise focuses on "eye 
fixation." This tricky little routine is 
supposed to help develop peripheral 
vision by flashing two sets of letters 
on each side of a dot in the center of 
the screen; first two letters, then four, 
and finally six— at three different 
speeds. You must stare at the dot, 
read the letters using your peripheral 
vision, and retain them in your 
memory long enough to duplicate 
them with the keyboard. 

The second lesson exercises eye 
movement. After you enter your 
reading rate (in wpm), the computer 
displays the text faintly on the screen 
and highlights groups of words for 
you to read in a zigzag pattern, 
across and down the page. Each time 
the program highlights a new set of 
words, it directs the computer to 
sound a beep, 

The third exercise is a column- 
reading drill, It is similar to the eye 
movement lesson in format: but in- 
stead of zigzagging, It displays the 
text down the center of the screen. 
You set the wpm rate and the width 
of the line of highlighted text (from 
16 to 26 characters). 

Speed Reading provides practice 
text, however you can load your own 
text file, as long as it is an ASCII file 
saved in display/variable 80 format, 
and the text does not exceed 100 
lines. 

To help you pace yourself as you 
read from a source other than the 
computer, the program supplies a 
reading pacer. You enter the speed 
you want to practice with, and the 
program beeps out a steady rhythm 
to help you maintain it. 

The manual provides practice ses- 
sions that incorporate the eye fixa- 
tion and eye movement exercises. 
You work with these for 15 minutes 



each, then take a comprehension 
test. The final practice session has 
you using the reading pacer option 
as you read from a book or magazine. 

Is It Worth It? 

Although Speed Reading is very 
easy to use, It does have a few pro- 
blems that I want to point out. First, 
the manual seems hastily written, 
with lots of typos and vague sen- 
tences. Its explanation of how people 
read and descriptions of exercises are 
ambiguous. For example, the eye fix- 
ation exercise limits you to 6 letters, 
but the manual implies that you can 
practice with 8. Navarone should 
have maximized its program to 8 or 
even 10 letters— I found it just too 
easy to read and retain 6 letters. The 
eye movement exercise limits you to 
only 100 lines of text, so you end up 
re-reading the same text over and 
over, or stopping your exercise every 
few minutes to load a new file. And 
finally, I was a bit put off by the 
general "it's all up to you M tone of the 
manual. People who really need to 
Improve their reading speed require 
more guidance than the program's 
documentation provides, 

What really bothers me about 
Speed Reading, however, is the ap- 
parent lack of thoroughness on the 
part of the developers. It left me feel- 
ing that the entire package was 
prepared in a somewhat perfunctory 
fashion. It could really stand some 
Improvement, starting with a new 
manual. With a little more work, 
Navarone could possibly turn Speed 
Reading into a more useful and much 
friendlier program. But until this hap- 
pens, you might want to spend your 
money on more conventional and 
perhaps even more thorough speed- 
reading courses. ^p| 
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Applesoft Listing Formatter 



Many BASIC programmers 
"crunch" their code, putting 
multiple statements on one line to 
use memory as efficiently as 
possible. Programs written in this 
format are compact and run 
quickly, but can be difficult to 
read* Here's a handy program in 
Applesoft BASIC that reformats 
listings to put each BASIC state- 
ment on its own line. 

Listing Formatter requires a 
BASIC program listing to be 
resident on disk in the form of an 
ASCII text file. You can ac- 
complish this by LOADing the 
program you want to list, keying 
in the Capture program listed on 
page 74, and entering RUN, The 
Capture program converts a 
BASIC program in memory into 
a text file on disk. 

Once you have created the 
text file on disk, you can LOAD 
and RUN Listing Formatter, The 
program asks you for the name 
of the text file containing the 
listing, and then starts printing, 
Example output appears below. 
After the program OPENs the 
text file, the formatting algorithm 
reads one character at a time and 
checks for carriage returns, 
quotes, colons, and spaces. If it encounters a carriage return, it prints the current line and 
goes to the next one. It counts the number of characters up to and including the first space 
after the line number, and when it hits a colon that is not inside quotes, it goes to a new 
line. The program uses the number of characters it has counted to indent the current line 
so that it lines up properly under the line above it. 

When the program reads past the end of the text file, Error Number 5 (END OF DATA) 
occurs. The program finds the error number by PEEKing location 222, then branches to the 
cleanup routine and ends. 

—Steve Weersing 

- Before formatting 



- After formatting 
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HCM Glossary term*: algorithm, ASCII, flag, text file. 
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Atari Listing Formatter 
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One of the best ways to Im- 
prove your programming skills Is 
to evaluate another person's pro- 
gram listing. Evaluating program 
listings is also the best way to find 
program bugs. Someone else's 
listings, however, aren't always 
easy to follow. When a program- 
mer "crunches" a program by us- 
ing multiple statement lines of 
nearly maximum length, un- 
tangling these long lines of 
BASIC commands and 
statements can be quite a task. 
The utility program that we pre- 
sent here, Listing Formatter, 
enables you to decipher long, 
compacted program lines by 
listing your programs in a more 
readable format. The utility neat- 
ly prints out each Atari BASIC 
statement onto a separate line 
(see the "before and after" for- 
matting sample below), Notice that by Indenting the separated statements, the utility makes 
the margin available for remarks. 

To use this utility, you must first convert the program to be listed into an ASCII text file. 
Do this by loading the program Into memory and USTing it to disk or tape. For example, 
to LIST a program entitled GAME to disk, first LOAD it Into memory and then enter the 
following: 

LIST "DtQAME.L" 

The extension .L differentiates the LISTed version of GAME from the program version. Now, 
LOAD and RUN Listing Formatter. When prompted, enter the program file name. For the 
above example, you would enter a file name of DtGAME.L. Before pressing [RETURN], make 
sure that your printer is hooked up and on-line. Once you press [RETURN] , the utility sends 
the formatted listing to the printer* 

The logic behind this utility is very simple. A loop reads in program lines while searching 
for colons, the statement separators. When it finds a colon, the formatter routine outputs the 
separated statement to the printer, then continues the search, Obviously, the program should 
Ignore colons that occur inside quotes, To flag quotes, we use the appropriately named variable 
QUOTE. If QUOTE equals zero, the routine searches for colons. If QUOTE does not equal zero, 
the routine ignores colons. 

^Randy Thompson 
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Frequency 
Blender 

by Stave Weening 

HCM Staff 



We are all familiar with the differences in tonal 
color among musical instruments. The liquid 
smoothness of the French horn and the siz- 
zling bite of the electric guitar are distinctive because 
they produce differently shaped sound waves. The 
simplest sound has the shape of a sine wave and is a 
pure tone. 

Every sound, no matter how simple or complex, can 
be broken down into one or more component sine 
waves. Complex waves— waves that consist of two or 
more sine waves— contain a fundamental sine wave and 
at least one harmonic* The fundamental component 
determines the pitch that we perceive in a complex wave 
form, The harmonic components govern the tone color. 
Frequency Blender displays 4 sine waves with fre- 
quencies and amplitudes that you supply, then shows 
you their algebraic sum, known as the resultant. All 5 
waves have the same height on the screen display so 
that you can see each wave clearly. When calculating 
the resultant, however, the program does take into ac- 
count the amplitude of each component* 

Making Waves 

When you RUN the program, it asks you to enter fre- 
quencies and amplitudes for the 4 components and to 
specify the number of cycles of the lowest frequency that 
you wish to see on the screen. This last value sets the 
horizontal scale for the display, Negative amplitudes 
produce waves that are 180 degrees out of phase (up- 
side down). 

Because the horizontal resolution of the screen Is 
limited, there is a restriction to the number of cycles 
that the screen can display clearly. If you try to display 
more than 50 cycles of the highest frequency, the 
display may distort whole cycles in the sampling and 
show a wave with a frequency lower than it actually has, 

Examples 3 and 4 show approximations of square and 
triangle waves. You can obtain other interesting results 
with the values in these two examples: 
44 © Home Computer Magazine 1985 Volume 5, No. 6 



Humble sine waves— the simplest of 

tones— combine under your control 

to produce complex waveforms. 



Note: Frequency Blender first appeared in the "IBM- 
presslons" column of Vol. 5, No, 3, and In the Apple 
Seedlings column of Vol. 5, No. 5, For our Atari reader, 
we now offer a version here In "Atari Atrium"— Ed. 



Example 1: 

FREQUENCY #1: 100 
AMPLITUDE: 100 

FREQUENCY #2: 110 
AMPLITUDE: 100 

FREQUENCY #3: 120 
AMPLITUDE: 100 

FREQUENCY #4: 130 
AMPLITUDE: 100 

Number of cycles of 
lowest frequency: 50 



Example 2: 

FREQUENCY #1: 100 
AMPLITUDE: 100 

FREQUENCY #2: 200 
AMPLITUDE: 100 

FREQUENCY #3: 300 
AMPLITUDE: 100 

FREQUENCY #4: 400 
AMPLITUDE: 100 

Number of cycles of 
lowest frequency: 10 



How it Works 

The seemingly complex task of adding these 
waveforms to produce their algebraic sum is actually 
straightforward. The program holds the frequency and 
amplitude values for the 4 component waves in the ar- 
rays FR( ) and AMP( ). After the 4 component waves are 
plotted, each of the 320 elements of a third array, SUM( ), 
will determine the position of the composite wave. 

Before plotting any waves, the program sets all 320 
elements of SUM( ) to zero* It then goes through a FOR- 
NEXT loop 4 times, drawing one of the component waves 
each time. An Internal FOR-NEXT loop controls the plot- 
ting of the 320 horizontal positions for each component 
wave, calculating the vertical displacement of each 
point. The program also figures the relative effect that 
the wave has upon the composite wave, and then adds 
the value into the corresponding element of the SUM( ) 
array. Thus, after the program draws the 4 component 
waves, SUM( ) already contains the values needed to plot 
the composite waveform. 



Example 3: These frequency and amplitude values result in a close 
approximatation of a square wave: 



FREQUENCY #1: 100 
AMPLITUDE 1: 100 

FREQUENCY #2: 300 
AMPLITUDE 2: 33 

FREQUENCY #3: 500 
AMPLITUDE 3: 20 

FREQUENCY #4: 700 
AMPLITUDE 4: 14.28 
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Number of cycles of lowest frequency: 4 

Example 4: These frequency and amplitude values result in a dose 
approximation of a triangle wave: 



FREQUENCY # 1: 100 
AMPLITUDE 1: 100 

FREQUENCY # 2: 300 
AMPLITUDE 2: -11.11 

FREQUENCY # 3: 500 
AMPLITUDE 3: 4 

FREQUENCY # 4: 700 
AMPLITUDE 4: -2.04 
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Number of cycles of lowest frequency: 4 

In order to scale the composite waveform, the pro- 
gram examines SUM( ) and looks at each element to 
determine SB (SumBig). the peak amplitude of the 
resultant. 

Notice that the program uses the PLOT statement to 
position only the first point of each plot (line 310). To 
improve the clarity of the display, the program uses the 
DKAWTO statement for subsequent points, drawing lines 
between points instead of plotting only the points. 

As the program plots each component wave, it 
displays the frequency and amplitude on the bottom 
of the screen. Once the display is complete, the compo- 
nent and composite waves remain on the screen until 
you press any key. Then the program gives you the op- 
tion to continue with another set of waveforms or to exit 
the program. 

HCM Glossary terms: amplitude, component, cycle, frequency, fun- 
damental, harmonics, overtones, resultant, sine wave, waveform. 



KEY VARIABLES 



PR( ) =s Frequencies of component waves; AMP( ) = 
Amplitudes of component waves; fm = Lowest compo- 
nent frequency; CY = Number of cycles of lowest fre- 
quency to display; D = Function value (displacement) of 
each wave at each horizontal plot position; SUM( ) = 
Function values for resultant; X = Horizontal plot posi- 
tion and loop counter; Y = Vertical plot position; SB = 
Amplitude of resultant; I and T are loop-counter variables. 
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LISTING ANNOTATIONS | : 




Frequency Blender 




(Atari SOO v SOOXL, 130XE) 


LineNos. 




100-200 


Program header 


210 


Initialize screen display and variables 


220-280 


Get input values, set FM 


290 


Initialize SUM( ) 


300-320 


Calculate and plot D, accumulate into SUM( ) 


330 


Determine SB 


340 


Plot resultant, wait for keystroke 


360-380 


Display SB, get keystroke, branch to beginning 




or end 


390-400 


Error routine for bad numeric values 



Thinking of Subscribing? 

Remember these time-worn truths: 

"A watched pot never boils." 

"Patience is a virtue." 

"Good things come 
to those who wait." 

"Allow 6-8 weeks for delivery 
of your first issue." 
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BASID 



by Randy Thompson 

HCM Staff 



Commodore 
Hornblower 



BASID takes the pain (and the POKEs) 

out of programming sound on the C-64 

by adding 18 new commands 

and 1 7 functions to your 

computer's vocabulary. 



In previous issues, we have used the pages of this 
column to give you a taste of the SID chip's various 
capabilities. We've shown you waveforms, 
envelopes, Alters, ring modulation, and even syn- 
chronization. Now, we think it's about time you tried 
programming some of your own custom sounds. To 
make the task of creating sounds on the Commodore 
64 easier, we've developed a special "sound 1 ' language. 
BASID adds 18 sound commands and 17 functions to 
your Commodore 64. 

To use these new commands, you must first type in 
or LOAD BASID 's BASIC loader. When you RUN the 
BASIC loader, BASID automatically activates, making 
all of the new sound commands available. You can use 
any of BASID' s statements in both immediate mode and 
program mode, 

See the Command Chart on the following page for a 
complete list of BASID's commands. The commands 
are in uppercase boldface, and the command 
parameters are in lowercase italics. For comparison, we 
have also included the BASIC equivalent of each BASID 
command. Note that, for most of these commands, it 
is impossible to give a true BASIC equivalent. For ex- 
ample, it is Impossible from BASIC to simply set the at- 
tack of a voice without setting the decay at the same 
time, yet it is easy when you use BASID. In these cases, 
we have provided the closest BASIC equivalents. 

Tbe Functions 

It is normally impossible to read the values stored in 
the SID chip's registers, BASID is unique, however— 
it allows you to read these values by using BASID com- 
mands (except for INIT] as functions. For example: X = 
EKQ(l) returns (gives you) the current frequency of voice 
1 and places it in the variable X. 

On the Commodore 64, you must follow all functions 
with an argument (the number a function operates on 
to produce its results) placed in parentheses. BASID's 
functions are no exception. In the example above, the 
argument specifies the voice (1, 2, or 3) that we wish 
to receive information about. In fact, in all but 6 of 
BASID's functions, the argument designates the voice. 
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These functions— VOL (volume), LO (lowpass filter), BAN 
(bandpass filter), HI (highpass filter), CUT (cutoff frequen- 
cy), and RES (resonance)— do not refer to any one voice, 
so they do not use the voice as an argument. Each of 
these functions requires a dummy argument. In other 
words, it does not matter what number you use as an 
argument— the function returns the correct value 
regardless of what argument was used. 

Here are some examples demonstrating the use of 
BASID functions: X = SOUND (2) returns the status of 
voice 2. If voice 2 is on, X equals 1. If voice 2 is off, X 
equals zero. The function X = VOL (7) returns the cur- 
rent volume setting. The argument 7 is a dummy argu- 
ment and has no effect on the value placed in X. The 
statement POKE 53280, VOL (3) changes the screen's border 
to the color corresponding to the current volume set- 
ting. Another interesting piece of coding sets the fre- 
quency of voice 2 to the current pulse width of voice 
1: FRQ PULSE (l) t 2 

A Sample Program 

On the next page, we have provided a sample pro- 
gram. We call it BEEHZZOW because of the peculiar 
sound it produces. Example 1 is the BASID version of 
BEEHZZOW, Example 2 is the BASIC version. As you 
can see, the BASIC version is both longer and less 
readable. You will find that the BASIC version is also 
much slower. In fact, the BASIC version is so slow that 
the sound effect is almost lost. Remember, in order to 
RUN a program that uses BASID commands, you must 
RUN BASID's BASIC loader first. 

It's Your Turn 

We've provided the language; it's up to you provide 
the talent. Try creating some simple sound effects, or 
writing your own arrangement of Beethoven's 5 th. How 
about using BASID to write a program that converts part 
of the Commodore keyboard into a musical keyboard? 
Whatever you do, use BASID: You'll find that it's a lot 
easier than POKEing sound out of the Commodore. And, 
when you've written your masterpiece, send it to us— 
you might see your name in print. 



General Commands 
DRT 

Clears (initializes) the sound chip. 

BASIC equivalent: FOR I = 54272 TO 64296 : POKE 1,0 : NEXT I 

VOL volume 

Sets the volume, The volume must be between and 15 or an 

ILLEGAL QUANTITY error will result. A value of is the lowest 

volume setting, while 15 is the highest. 

BASIC equivalent: POKE 54296, volume 

SOUND on/off r t voice 

Gates a voice on or off. Use an on/off value of 1 to turn the gate 

on (start the note), or a to turn the gate off (end the note off). 

The voice must be a number between 1 and 3, 

BASIC equivalent: POKE 54269 + voice*? ,on/otf '+ waveform* 16 

Pitch And Waveform 
FRCL frequency, voice 

Sets the frequency (pitch) of a voice. The frequency can range 

between and 65535. 

BASIC equivalent: HB = Tm<frequencyt256) : LB^egueztcy-HB 

•256 : POKE 54265 + voice* 7. LB : POKE 54266 + voice* 7, HB 

WAVE waveform, voice 

Sets the waveform of a voice. The waveform parameter must 

be 1-4. Here's a list of the possible waveform settings: 

1 - triangle 

2 • sawtooth 

3 - pulse 

4 - noise 

BASIC equivalent: POKE 54269 + voice * 7,1 6 *2\{wavefonn- 1) 
PULSE pulse width, voice 

Sets the pulse width. The pulse width value must be between 
and 4095. This command is only effective when used in con- 
junction with a pulse waveform, 

BASIC equivalent: HB ■ INT(p ulse width /256) : lB=pulsewidth 
- HB * 256 : POKE 54267 + voice*? ,12 : POKE 54268 + voice*7,HB 

Envelope 

ATTACK attack, voice 

Sets the attack of a voice. The attack parameter must be - 15. 
BASIC equivalent: POKE 54270 + voice* 7 t attack 



DECAY decay, voice 

Sets the decay. The decay parameter must be 0-15. 

BASIC equivalent: POKE 54270 + voice* 7, decay* 16 

SUS sustain, voice 

Sets the sustain. The sustain value must be 0-15. 

BASIC equivalent: POKE 54271 + voice* 7 .sustain 

BEL release, voice 

Sets a voice's release. The release parameter must be 0-15. 

BASIC equivalent: POKE 54271 + voice*?, release* 16 

Filtering 

FILTER on/ off, voice 

Turns on or off the filters of a given voice. A value of 1 filters the 

voice, while turns off the filter. 

BASIC equivalent: POKE 54295,21 (voice- 1) 

hO on/otf 

Turns the lowpass filter on (1) or off (0). 

BASIC equivalent: POKE 54296,1 6 *on/off 

BAN on/otf 

Turns the bandpass filter on (1) or off (0). 

BASIC equivalent: POKE 54296, 32 *on/off 

HI on/off 

Turns the highpass filter on (1) or off (0), 

BASIC equivalent: POKE 54296, bA*on/oU 

CUT cutoff 

Sets the cutoff frequency of the filters. The cutoff value must range 

between and 2047. 

BASIC equivalent: HB = INT(cutaff/8) I LB =: CU faff -HB # 8 : POKE 

54293,LB : POKE 54294,HB 

RES resonance 

Sets the filters resonance. The resonance value must be between 

and 15. 

BASIC equivalent: POKE 54295, resonance* 16 

Special Effects 

RING on/otf, voice 

Turns ring modulation on ( 1] or off (0), 

BASIC equivalent: POKE 54269 + voice *7 t on/ott M 

SYNC on/off, voice 

Turns synchronization on (1} or off (0). 

BASIC equivalent: POKE 54269 + voice* 7, on/oft *2 





Command 


Function 


(seta value) 


(returns value) 


INTT 


-none- 


VOL (0-15) 


VOL<D) 


FRQ (0-65535).V 


FRG(V) 


WAVE[1-4),V 


WAVECV) 


PULSE (0-4095),V 


PULSE (V) 


ATTACK (0-1 5).V 


ATTACK (V) 


DECAY «M5),V 


DECAY (V) 


SUS(0-15),V 


SUSCV) 


REL«M5),V 


REL(V> 


SOUND (0/D.V 


SOUND (V) 


FILTER (0/1 ),V 


FILTER (V) 


LO(0/l) 


LO(D) 


BAN 0/1) 


BAN (D) 


HI (0/1) 


HI CD) 


CUT (0-2047) 


CUT (D) 


RES (0-15) 


RES(D) 


RING(0/1),V 


RING(V) 


SYNC (0/l),V 


SYNC (V) 


V denotes Voice and must be represented by a number between 1 and 3, 


D denotes Dummy argument and can 


be represented by any number. 



Example 1 
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Example 2 
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Send your BASID programs to: 
Home Computer Magazine 
Attn: Commodore Hornblower 
1500 Valley River Drive, Suite 250 
Eugene, OR 97401 

HCM Glossary terms: argument, attack, decay, dummy argument, 
envelope, frequency, function, parameter, pulse width, release, ring 
modulation, SID, sustain, synchronization, waveform. 

For your type-In listings, see HCM PROGRAM LISTINGS CONTENTS. 

HCM 



KEY VARIABLES 



D - Variable that reads machine language data; I = 
Memory location loop counter that stores machine language; 
C = Checksum variable that ensures correct entry of data 
statements. 



Line Nos. 

100-180 

190-200 

210 

220 

230-1860 



LISTING ANNOTATIONS 



BASID 9 s BASIC Loader (C-64) 

Program header 

Read and store machine language data 

Verify checksum 
Initialize BASID 
Machine language data 



© Home Computer Magazine 1985 Volume 5, No. 6 47 



tl 



■■ Jl !■ I « ■> II mi tl Ml Mm mi ■■■ i 



I _UI 1 II ~~i -LI 




Alarm Clock 



When you are working with computers, it is not difficult to lose track of time. With this 
easy-to-use program, and a little help from Commodore's built-in Time Of Day (TOD) clock, 
you can rely on your computer — not yourself — to remember when it's time to do something else. 

Like a normal alarm clock, this program allows you to set both the time and the alarm. 
When the alarm goes off, the computer interrupts its operation, and the screen's border seems 
to come alive. To turn the alarm off, press the back-arrow key located in the upper- left cor- 
ner of the keyboard. The border then stops strobing, and the computer resumes its opera- 
tions as usual. Sorry, but there is no "snooze" button on this alarm. 

When you RUN the program, a prompt asks you to enter both the current time and the 
alarm time. Enter these times in HHMMSS (Hours, Minutes, Seconds) format. For example, 
if it is 2:35 and 10 seconds, enter 023510. When prompted, press the A key for AM or the 
P key for PM. Once you have set the alarm, you can erase the Alarm Clock program and 
use the computer for almost any purpose, without disabling the alarm, 

When you employ this program, you are actually using Commodore's TOD clock. This 
is not to be confused with Commodore's "jiffy clock," which is controlled through variables 
Tl and TI$, Although the "jiffy clock" is easier to use and understand, it is less dependable 
(it stops running during certain I/O operations), and it has no alarm function. The TOD clock, 
on the other hand, is accurate — even during I/O— and has a user-settable alarm that causes 
an interrupt request at alarm time, 

Memory locations 56328-56331 (SDC08-SDC0B) are the TOD clock's registers. The time 
is represented as follows; 

Memory Location Purpose 

56328 (SDC08) Tenths of seconds 

56329 (SDC09) Seconds 

56330 (SDCOA) Minutes 

56331 (SDCOB) Hours 

Time is stored in these registers in Binary Coded Decimal (BCD), In BCD, a byte is di- 
vided into two nibbles, each nibble representing one decimal digit. For example, at 12 o'clock, 
the hours register (memory location 56331) contains a binary 00010010, Dividing this byte 
into nibbles, we get 0001 and 0010, representing the decimal digits 1 and 2 for 12 o'clock. 
All of the TOD clock registers work in this manner. The high bit of the hours register in- 
dicates either AM or PM: If it is PM, this bit is set (contains a one); if it is AM, the bit is 
clear (contains a zero). 

These registers have a unique latching feature. When you read (PEEK) the hours register, 
all of the other registers freeze up until you read the tenths-of -seconds register. This prevents 
you from receiving an inaccurate reading. For example, if you read the hours register at 
11:59 and the time changes to 12:00 Just before you read the minutes, the latching feature 
prevents you from thinking that it is 11:00 instead of 11:59 or 12:00. Although the registers 
freeze, the internal clock does not. So, the moment you read the tenths-of -seconds register, 
all the registers update to the proper time. 

By POKEing these registers you can accomplish one of two tasks— either set the clock or 
set the alarm. To specify which one, you must manipulate the high bit of memory location 
56335. If you set the high bit, then POKEing the TOD registers sets the clock. To set the alarm, 
clear the high bit. Refer to lines 200 and 220 of Alarm Clock to see how to manipulate this bit. 

The subroutine located in lines 270-360 sets both the clock time and alarm time. Lines 280-290 
receive and verify your input. Line 300 converts this input into a numeric array of single 
digits. Lines 340-350 use this numeric array to POKE the time into the TOD registers in BCD 
format. The AP variable signifies AM or PM. 






? I 




Now that you have set the 
alarm time, you must turn the 
alarm on. To enable the alarm, 
use the following code: 

POKE 56333,PEEK<56333) OR 132 

This code is in line 240 of 
Alarm Clock. After enabling the 
alarm ; the program POKEs this 
location with a zero to ensure that 
no other system "alarms" are 
activated, 

When the alarm goes off, it 
generates an interrupt request, 
An interrupt request normally 
forces the computer to execute 
the interrupt routine located at 
59953 ($EA31). In order for the 
Alarm Clock program to know 
that an interrupt has occurred, 
we use a short machine-language 
routine to intercept the normal 
interrupt routine. This machine- 
language routine shows up in 
lines 420-750. The first part of this 
routine changes the interrupt 
vector located at 788-789 
($314-3315) so that it points to our 
new IRQ routine at 49165 
($CQ0D), It's the new IRQ 
routine's job to find the cause of 
any interrupt. If the TOD alarm 
is not the cause, then the routine 
returns control to the normal in- 
terrupt routine, If the TOD alarm 
is the culprit, then the border 
flashes, and all computer opera- 
tion halts until you press the 
back -arrow. 

Currently, the starting address 
for Alarm Clock's machine 
language is 49152 (SCOOO). If you 
wish to alter this, simply change 
the variable SA in line 190 to 
equal another location. The 
cassette buffer, located at 828 
($33C), makes a good 
alternative, 

—Bandy Thompson 

HCM Glossary terms: BCD, byte, 
high bit, Interrupt request, machine 
language, nibble, TOD, 



r 

R 
H 
S 
D 

p|o 

T 

pn 

MM 

PO 

R 



PO 



EM 

EH 

EH 

EM 

EM 

EM 

EM 

E 

E 

A 

D 



HMMS 



K 
3 

S 

I 

s 

D 
EH 



6 

PO 
9 

R 



EM 



CO 
EHE 



HOM 



RQ 



I 



HA 



rpn 

5 5 

TO 
H 



TO 

S 

* 

3 

EM 



CO 



COM 
I OH 



TO 

O 



EME 



RH 



00 



[00 

s 

F 

fflol 



CH 
D 



1 

11+ 
4 

n 



s 
s 

M|A)C 



EW 



s 
Kioto 



MA 

D 
1 



PM 



+ T 



HO|M|P 

T 
6 



AM 



TO 



PO 

NG 



RM 



SO 



RM 



• + T 



AG 



AG 



NG 



SA 



AND 



HO 



NG 



8 

tflAb 



RQ 



LOO 



POK 



AG 



8 
RM 



A!+ 
H 



NG 



RM 

NG 



ROR 



ROU 



S 

D 

CM 

H 



C 
JM 



ME 
EM 



CO 



EM 



NG 



LOO 



DC 

ie 

X 
PC 



IEAS1 



RQ 
14 
RQ 



to Home Computer Magazine 1985 Volume 5, 



No. 



6 



"48- 




The Binary Tree 

by William K. Balthrop 

HCM Staff 

See how recursion lets you imitate nature 
by growing a tree on your computer screen. 



Take a look at the screen shot on this page. Judg- 
ing by appearance, you might think that the tree 
it depicts was drawn with the help of a fancy 
graphics program. On the contrary, a simple BASIC pro* 
gram is responsible for the display. By loading and run* 
ning this program, you can create a version of this tree 
on your monitor. 

The Binary Tree draws the tree using "recursion." 
Recursion is a powerful programming technique where- 
by a procedure repeats itself until a specified condition 
is met. Most of us have seen this concept illustrated by 
paintings in which the artist has drawn the actual pic- 
ture, which contains the picture, which contains the pic- 
ture, and so on. Similarly, this pro- 
gram creates a graphic tree by 
repeating a branch-drawing routine 
until the tree is complete, 

Spiraling Branches 

Trees provide a perfect example of 
recursion. The overall pattern of the 
tree is repeated in ever-smaller levels; 
first in the tree itself, then in the large 
groups of branches, in the smaller 
groups of branches, and finally, in 
each twig. Each repetition represents 
a "level of recursion." In this program, 
each level of recursion draws a branch segment. 

The program begins by drawing the trunk and then 
creating a branch that is 14 pixels In length. The recur- 
sive loop then calls itself and draws another branch at 
a 90 degree angle to the right of the first branch. This 
branch, and each consecutive branch, is one pixel 
shorter than the branch that preceded it. 

At each level, the program saves the following infor- 
mation: the X and Y coordinates of the branch junction 
(where a larger branch meets one or two smaller 
branches), the length of the branch, and the number 
of branches at the current level, When the recursive pro- 
cess reaches its limit— i.e. , when It draws a branch that 
is only one pixel long— it uses this information to back 
out to the preceding junction. 

The program draws only two branches at each junc- 
tion. Therefore, if the junction has just one branch— 
the right-hand branch— the program draws another 
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Take a recursive algorithm, add 
a little color, and voila—a tree! 



series of spiraling branches to the left. If two branches 
already spiral off the junction, the program moves back 
to the previous junction, and so on. The entire program 
is complete when all Junctions have two branches 
leading from them, (Figure 1 illustrates the path of the 
recursive process.) 

Random Branches 

The recursive algorithm, as we have explained it so 
far, always produces the same predictable geometric 
pattern— resulting in the same predictable, symmetrical 
tree each time. Trees in nature, however, do not have 
the luxury of an IBM to keep their branches in order, 
So, to simulate the variety of nature, 
we have added some random factors. 
For each branch, the program 
generates a random number between 
and 15. If the number that the com- 
puter produces lies between 4 and 1 5 
(which it does approximately 81 per- 
cent of the time), the next branch that 
the program draws is one pixel shorter 
than the previous branch. If the 
random-number generator picks 0, 
the next branch is one-half the length 
of the previous branch. A random 
number of 1 results in a branch with 
a length that is 70 percent of the 
length of the previous branch. A value of 2 makes the 
next branch's length 80 percent that of the previous 
branch. 

Colorful Branches 

The most attractive aspect of the tree is not the 
algorithm we use to draw it, but the colorful way that 
it resembles a real tree in full bloom. The program does 
this easily by monitoring the length of the branches. 

The program starts out creating a branch that is 14 
pixels long. At every junction, the program reduces the 
next branch's length by one pixel (unless the random 
factor reduces the length by more), If the length is 
greater than 4 pixels, the program goes to a routine that 
draws brown branches. This routine also checks the 
branch's length to determine how broad the branch 
should be drawn. 



If the length of the branch is 4 pixels or less, the pro- 
gram goes to another routine. This routine draws a 
green branch if the length is one through 4 pixels; a red 
dot if the length of the branch reaches zero. 

Experiment 

If you are the experimental type, you may like to try 
changing a few parameters to alter the shape of the tree. 
In line 450 you can determine how symmetrical the out- 
come will be by changing the multipliers that shorten 
the branches (.5, .7, and .8). In the same line, you could 
modify the values compared to RN to alter the ran- 
domness factor. In line 450 you could change the 1 at 
the end of the line to 2, 3> 4, or possibly 5. This will af- 
fect the speed In which the tree reaches the smallest 
branch size. If you reduce this value too far, you may 
receive a subscript error as the maximum recursion 
level is 100. You could change the maximum level, 
however, by increasing the DIMensioned size of RE( , ) 
in line 270. 

HCM Glossary terms: call, level of recursion, recursion, random number 
generator. 
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Figure 1: The recursive algorithm spirals inward until it has drawn 
the smallest possible branch. It then backs out, looking for junctions 
to branch out from, and continues the process. 
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LISTING ANNOTATIONS j : 


Binary 


Tree (IBM PCjr, PC, Tandy 1OO0 PC) 


LineNos. 




100-230 


Program header 


240-320 


Initialize program variables 


330-380 


Main recursion loop 


39CM20 


Adjust direction 


430-470 


Save the data of current level ol recursion 


480-520 


Control color of branch 


530-630 


Draw brown branches 


640-680 


Draw green and red branches 


690-720 


Get the coordinates of the previous and current 




levels of recursion 


730-760 


Halt program 


770*800 


Data for the DIE array which determines 




direction 


810-S30 


Wait for a keypress 



KEY VARIABLES 



as ■ Value of keypress; RE( , ) = Recursion level in- 
formation; DIR( , ) = Direction values; D - Current direc- 
tion; LX.LY.RX.OT = Offset used in drawing the branch; 
R ■ Current level of recursion; rn = Random number; 
Xl,Yl = Coordinates of current branch junction; X2.Y2 
as Coordinates of previous branch junction; Z = Utility 
variable for loops. 



u 11 ' *************** 


[ 110 ' * BINARY TREE • 

E 130 ' *************** 


X 130 ' COPYRIGHT 1985 


a 140 ' EMERALD VALLEY PUBLISHING CO, 


o 150 ' BY WILLIAM X. BALTHROP 


u 180 ' HOME COMPUTER MAGAZINE 


D 170 ' VERS I ON 5.6.1 


T 180 ' DOS 2.1 and ilthn 


m 100 ' IBM PCjr with CARTRIDGE BASIC or 


E 200 ' IBM PC with BASICA and 


D 210 r COLOR/GRAPHICS ADAPTER and 


P 220 ' COLOR MONITOR or 


s 250 ' TANDY 1000 PC with GW BASIC 


x 240 ' INITIALIZE PROGRAM 


a 250 J 


o 260 DEFINT A-Z : RANDOMI ZE TIMER 


w 2 70 DIM RE ( 1 00 , 4 > , DI R { 8 , 2 ) 


y 280 FOR Z-1 TO 8: READ DIR ( Z , 1 j , DI R ( Z , 2 ) 


: NEXT 
h 290 SCREEN 1: COLOR 0,0;CLS 


e 500 LINE (0,190)-(319,199),1,BF:DRAW "C 


3BM140,199R40HU3HU3HU3HU3HU3HU3HU3H 


U3HU3HU40H10G10D40GD3GD3GD3GD3GD3QD 


3GD5GD3GD3GBM1S0 , 140 PS , 3 " 


d 310 R»2 : DM : RE ( 1 , 1 >=1 60 : RE { 1 , 2 ) «120 : RE { 


1 , 3 }«14 : RE ( 1 , 4}-1 


w 320 ' 


I 330 ' MAIN RECURSION LOOP 


c 3 40 ' 


Y 350 IF R-0 THEN 750 ELSE IF HE(R,4)-0 T 


HEN D-D+1:GOSOB 410:GOSUB 450:GOSUB 


500: IF RE(R,5)>0 THEN H»H+1:GOT0 S 


50 ELSE D»D-1:GOSUB 410:GOTO 350 


F 360 IF RE(R,4)«1 THEN D=D-1:GOSUBi 410:G 


OSUB 450: GO SUB 500: IF RE(R r S)>0 THE 


N R r R+1:GOTO 350 ELSE R E ( R , 4 ) = : R - R 


-1:GOS.UB 410:GOTO 350 


p 370 RE { R . 4 )«0 : R-R-1 : D-D+1 : GOSUB 410:GOT 


3 50 


a 3 80 ' 


e 3 90 ' ADJUST THE DIRECTION BACK WITHIN 


ITS LIMITS 


z 4 ' 


B 410 IF D=0 THEN D«6:HETURN ELSE IF D = -1 


THEN D-7:RETUHN ELSE IF D«9 THEN D 


-1:RETURN ELSE RETURN 


:i 420 ' 


I 430 ' SAVE CURRENT POSITION FOR A LATER 


RETURN DURING RECURSION 


r 4 40 ' 


p 450 RE ( R , 1 ) «RE ( R-1 , 1 )-f ( RE ( R-1 , 3 » »D I R < D , 


1) ) :RE(R,2)«RE(R-1 , 2 } +{ RE ( R-1 , 3 ) *D I 


R(D,2}):RNbINT(RHD*15):IF RN<1 THEN 


i RE<R,3)»RE(R-T,S)*.5 ELSE IF RH<2 


THEN RE { R , 3 ) = RE ( R-1 , 3 ) • , 7 ELSE IF R 


N < 4 THEN RE(R,3)«RE(H-1,3}*.8 ELSE 


RE { R , 3 ) "RE ( R-1 , 3 ) -1 


m 46 0; RETURN 


a 479 ' 


K 480 ' DRAW THE BRANCHES ON THE SCREEN 


M 490 ' 


k 500 RE ( R , 4 )«HE ( R , 4 J+1 : I F RE{R,3]>4 THEN 


GOSUB 550 ELSE GOSUB 060 


a 510 RETURN 


G 520 ' 


s 530 ■ DO BROWN BRANCHES 


m 540 ' 


y 550 SOSUB 710;ON D GOTO 5 6 0,570,580,590 


, 560 ,579, 560 , 590 


s 560 LX--1 : L Y»0 : RI=+ 1 : RY=0 : GOTO 600 


d 570 LX = -1 : LY = -1 : HX=+1 : RY= + 1 : GOTO 600 


i 5 80 LX=0 : LYk-1 : RX=0 : RY=+1 : GOTO 600 


o 590 LX» + 1 : LY«-1 : HX--1,: RY= + 1 


G 600 IF RE<R,3»>0 THEN L I N E ( X 1 + L X , Y 1 + L Y J 


-IX2+LX.Y2+LY) ,3 


h 610 IF RE(R,3}>7 THEN L I N E ( X 1 +R X , Y 1 +R Y ) 


-{ X2+RX , Y2+RY } , 3 


u 620; L INE [ 11 , Y1 )-( X2 , Y2 ), 3 : RETURN 


s 630 ' 


N 640 * DO GREEN AND RED BRANCHES 


ir 650 ' 


k 660 IF RE(R r 3)<1 THEN C**2 ELSE C-1 


X 6 70 GOSUB 710:L1NE(X1,Y1)-(X2,Y2),C:RET 


URN 


v 680 ' 


p 690 ■ GET COORDINATES 


K 700 ' 


a 710 X1=RE ( R-1 , 1 ) : Y1=RE ( R-1 , 2 ) : X2«RE ( R , 1 


) : Y2«RE ( R , 2 > : RETURN 


y 720 ' 


v 730 ' END OF PROGRAM 


e 740 ' 


M 750 GOSUB 8 30 : END 


c 760 ■ 


a 770 ' D I RECT I ON DATA 


s 780 ' 


m 790 DATA 0,-1,1,-1,1,0,1,1,0,1,-1,1,-1, 


, -1 ,-1 


j 800 ' 


£ 810 ' INPUT ROUTINE 


x 820 ■ 


a 830 Ua* " : WH I LE A 1 - " " : A 1 = I N E E Y 1 : WE ND : R E 


i f«h rn r 
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3-Dimensional Graphic Surfaces Made Easy! 



by Steve Weersing 

HCM Staff 



This intriguing technique will help you keep 3-D graphics in perspective. 



Imagine yourself spending a pleasant afternoon toss- 
ing rocks into a still pond or lake and watching the 
ripples spreading from the point of impact. Wouldn't 
it be great to see this fascinating natural process in more 
detail? 

We have all seen these ripples frozen in time by stop- 
action photography. Now we can see them on our home- 
computer screens as well. Spreading ripples are a good 
example of wave motion. Each ripple is a sine wave that 
gets weaker as it spreads out in all directions from the 
center. 

The Apple II family's high-resolution (hi-res) graphics 
screen offers you an effective medium for depicting 
these ripples. Ripples draws a graph showing 
diminishing waves expanding outward from a central 
splash— in three dimensions! At your option, it also 
demonstrates other graphic possibilities by drawing the 
graph with differently shaped waves. 

When you RUN the program, it displays a menu ask- 
ing you to select ripple patterns based on sine waves, 
square waves, or triangle waves. When you enter a selec- 
tion, the program clears the screen and draws the rip- 
ple pattern. It then waits until you press any key and 
asks if you wish to continue. If you do, it shows you the 
menu again. If you don't, it restores the ripple pattern 
on the screen and stops. You may clear the screen by 
holding down (CONTROL) and pressing [RESET]. 

A Little Background 

The most difficult aspect of drawing in perspective 
on a computer screen is keeping track of which parts 
of the drawing are in the foreground and which are in 
the background. How is the computer to tell which parts 
of the drawing are "behind" other parts? 

The solution involves drawing from the bottom of the 
screen (the foreground) to the top of the screen (the 
background) and suppressing parts of the background 
that are not supposed to "show through" parts of the 
foreground. 

The program draws 29 wavy horizontal lines from left 
to right, moving up the screen after completing each 
one. It draws each line by going along an invisible 
horizontal baseline containing 280 plot positions. At 
each horizontal plot position, the program calculates 
a vertical offset that places the current point above, 
below, or on the baseline. 
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Note: Ripples first appeared in the "IBMpressions" col- 
umn of Vol. 5, No. 2. We now present a version of this 
program for Apple II users. 



An array called MAP( ) contains the height of the 
highest point yet drawn at each horizontal plot position. 
The program compares each new point with the cor- 
responding point in the array. This allows it to deter- 
mine whether the new point is above or below an ex- 
isting wavy line. 

If the new point dips below any previous line, the pro- 
gram does not draw the portion that is underneath that 
line. Instead, it retraces the contour of the existing line, 
and continues drawing the new line when it emerges 
from "behind" the existing one. 

The program uses a similar technique whenever a line 
goes off the top or bottom of the screen. After calculating 
the vertical position of a point, the program checks to 
see if the point is on the screen. If it is not, the program 
draws to and along the edge of the screen until the next 
point is on the screen. 

There is no problem with the left and right edges of 
the screen because the program automatically draws 
from the left edge to the right edge, stops, and starts 
again at the left edge. 

How Big A Splash? 

The vertical offset of each wavy line from its baseline 
at any given point depends on the distance from that 
point to the center of the screen. The center of the screen 
has the X and Y coordinates (139,95). Our old friend 
the distance formula, based on our ancient friend the 
Pythagorean Theorem, gives us the linear (straight-line) 
distance from any point on the screen to the center. This 
distance, D, is equal to SQR«139~X>2 + (95-Y)-2). 

Plotting the cosine of D at each point along each 
baseline produces a ripple pattern of constant height. 
Such a graph is interesting, but it does not show the 
large central spike or the diminishing ripples found in 
nature, as when the stone hits the pond's surface. 

Because the size of the ripples diminishes as the 
distance from the center increases, the amplitude of an 
actual wave is inversely proportional to the distance 
from the center. Plotting COS(D)/D produces a graph with 
these qualities. Multiplying D by scaling factors in the 






This ripple graph, based on a sine wave, 
shows the splash at the center going off 
the top of the screen. 



This ripple graph is based on an approx- 
imation of a square wave, which is not a 
naturally occurring pattern. 



This ripple graph uses a different set of 
sine wave components to approximate a 
triangle wave. 



numerator and in the denominator allows you to adjust 
the size and proportions of the graph. 

Controlling The Screen 

When you use the HGRB statement, Applesoft BASIC 
selects the hi-res graphics screen with a 4-line text win- 
dow at the bottom- By using POKE statements, you can 
conveniently switch this window on and off. In Ripples, 
this feature brings back the bottom of the ripple graph 
after displaying the text window with a "Continue?" 
prompt 

The HGRB statement not only sets the hi-res mode, but 
also clears the screen. On the other hand, POKE - 16302,08 
turns off the text window, and POKE -16301,08 turns it 
back on— without clearing the screen. When you ex- 
ecute one of these POKEs, both the text window and the 
bottom of the hi-res screen retain whatever you last 
wrote to them. 

Because the TEXT statement does not clear the text 
screen, you can use it to bring back the text after using 
the graphics screen. You can clear the text screen with 
the HOME statement. 

Color Me Wavy 

If you have a color monitor, you may wish to experi- 
ment with foreground and background colors. If you 
change line 230 to read HGR : POKE - 16302,0 : HCOLOR = 3 
: HPLOT 1,1: CALL 62454 :HCOLOR = 6, the program will draw 
in blue on a white background. 



HCM Glossary terms: horizontal plot position. 



KEY VARIABLES 



HCM 



MAX( ) = Array to hold highest point plotted at each 
horizontal plot position; A$ = Character input; X = 
Horizontal plot position and loop counter; Y = Vertical 
position of each baseline and loop counter; D = Distance 
to center of screen; F = Vertical offset of point from 
baseline; P - Actual Y coordinate of each point plotted. 
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LISTING ANNOTATIONS | i 




Ripples (Apple II Family) 


Line Nos. 




100-190 


Program header 


200 


Dimension array 


210-220 


Menu 


230 


Set graphics screen 


240 


Calculate D 


250-300 


Plot each point 


310-330 


Wait for keystroke, get input, branch to begin- 




ning or end 


340 


Restore graphics at bottom of screen, end 




This chart illustrates the algorithm that draws the 
screen. At each point on a horizontal baseline, the pro- 
gram determines the distance D to the point A. it then 
calculates a vertical offset from the baseiine using 
COS(D|/D. At B1, a negative offset places the point to 
be plotted at B2. At CI , a positive offset places the point 
to be plotted at C2. 
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TI 
VENTRILOQUIST 

by Scott Williams 

HCM StalT 

Tune-in to intriguing sound effects 

with your TI computer 

and a few dazzling routines . . . 

What pops into your mind when someone men- 
tions computer simulations or arcade games? 
If you're like most people, you probably 
associate these words with striking graphics animation 
or the game scenario itself. 

But there is one very important feature built into most 
games and simulations that we tend to overlook, at least 
until we have to do without it—sound effects. Try turn- 
ing down the volume on your television or monitor, then 
play all your favorite games. You won't find them near- 
ly as interesting. 

The TI-99/4A is a great machine for sound effects 
because of its complex 4-voice sound chip, the TMS 
9919. This chip is capable of producing up to three tones 
and one noise at the same time. You can choose from 
8 different types of noises and a wide range of tones as 
the example programs on these two pages demonstrate. 
These programs are short enough for you to enter each 
one in just a few minutes, then sit back and let your 
computer take you into the world of special effects. 

Buzzy Bees 

Program I incorporates one tone and the noise chan- 
nel to approximate the sound of a swarm of bees. The 
first parameter in the CALL SOUND statement in line 200 
sets the duration of the sound in milliseconds. We use 
a negative number to set the duration. This causes the 
sound to continue until the next CALL SOUND statement. 
When it encounters the next CALL SOUND statement, the 
computer simply leaves the sound on and changes the 
tone. This results in a smooth transition between tones 
and a very realistic honey bee. 

Gun Fight 

Program 2 simulates a gun shot repeated at random 
intervals. The noise channel plays a big part in this 
sound effect. 

The TI computer responds to 8 noise parameters, 
each designating a different noise. To specify a noise, 
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you need to use a negative value between - 1 and - 8 
as a frequency parameter. Value - 5 is the closest ap- 
proximation to white noise— random frequencies 
dispersed evenly throughout the audio spectrum. 
Values - 6 through - 8 also produce noise—however, 
the lower frequencies contain more energy, which 
results in a lower pitched noise. Values - 1 through - 4 
create what the TI BASIC Manual refers to as "periodic 
noise." Technically speaking, this periodic noise is not 
a noise at all. It more nearly resembles the sound of a 
narrow pulse wave. If you specify a value of - 4 or - 8, 
the frequency setting of the third tone in the CALL SOUND 
statement determines the pitch of the noise. This 
reference chart displays the relative pitches of the 
various types of noise available on the TI sound chip: 

- 1 or -5 = high pitch 
-2 or -6 a medium pitch 

- 3 or - 7 b low pitch 

- 4 or - 8 = set by frequency of the third tone 

Motor Rev 

By mixing several sound effects together we can 
create a more complex simulation. Program 3 produces 
a very familiar sound: a car having difficulty starting 
up. The car motor turns over 8 times, then starts and 
slowly revs up. The engine holds a steady RPM for a few 
seconds then slows until it stops. 

A FOR-NEXT loop in lines 1 10 through 140 handles the 
initial turning over of the engine. We use a noise set- 
ting of - 8 with the third tone controlling the pitch of 
the noise. The loop counter then alters the frequency 
of the third tone, making the noise's pitch change. In 
the first CALL SOUND statement, the volume is at its max- 
imum level of 0. In the next sound statement we 
decrease the volume to 5 and alter the frequency of the 
third tone to drop the pitch slightly. This results in the 
whirring sound of the crank case turning over. 

The second FOR-NEXT loop starts the pitch of the noise 
channel at a very low level so that you can hear only 
clicks. These clicks increase in frequency with an in- 
crease in the frequency of the third tone, providing the 
thrumming noise of an idling engine. 

The next loop holds the idle tone for a few seconds. 
The final FOR-NEXT loop takes the pitch of the noise from 
its high "idle" back to a slow clicking. 

Hiccup 

Program 4 incorporates two noise types and all three 
tones to produce the type of sound you might expect 
to hear if your computer had the hiccups. The first 
sound you hear is a high-pitched "hie." Line 110 
generates this sound by setting the noise channel to - 8 
and setting the third tone at a frequency of 20000 Hertz 
(Hz). Voice two is used at a low volume to add a little 
tone color to the hie. 



The second sound that you hear is a lower frequen- 
cy. To achieve this effect, we specify the fixed-pitch noise 
- 7 and mix it with three tones of 330, 337, and 380 Hz. 

We have specified a positive duration to create a 
distinct break between notes. The sound lasts for the 
entire length of the duration, then ceases completely 
before the next note is played. 

Siren 

A police siren is a surprisingly complex sound to 
simulate. The sound, as first heard from a distance, is 
quiet. As the police car approaches, the siren becomes 
louder. Then the car passes, and the siren becomes 
quieter, fading into the distance. This variation in 
amplitude is fairly easy to reproduce on the computer. 
The complexity lies in a simultaneous oscillation in 
frequency. 

To produce this sound effect in Program 5, we need 
to control two parameters: the frequency of the siren 
as the sound fluctuates up and down, and the volume 
of the siren as it approaches and recedes. 

The simplest way to achieve this sound effect is to 
place the frequency oscillation aspect in a subroutine 
located in lines 250 through 280. The main program 
then cycles through two FOR-NEXT loops to control the 
increase and decrease in volume, calling the subroutine 
to play the siren. 

In nature, few things are as perfectly linear as FOR- 
NEXT loops. So, for the sake of realism, we added a fur- 
ther dimension to the routine. We placed both the 
volume and pitch under the control of the SIN function. 
Unfortunately the SIN function is not very fast. We have 
therefore eliminated it from the most repetitive areas 
of the program, placing a list of pre-calculated SIN values 
in an array to save processing time later. We also have 
calculated the SEN of Z before calling the subroutine, 
rather than calculating it through every iteration of the 
Yloop. 

Touch Tones 

Have you ever wondered what would happen if you 
sent simulated touch tones to the mouthpiece of your 
phone? The answer: You would dial the number cor- 
responding to the tones. The touch tones that dial your 
phone do not have to originate inside the phone; you 
can produce them externally with the same results. 



Program Listing 1: BUZZY BEES 



Figure 1 
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Touch tones are easy for your computer to generate. 
Each touch tone actually consists of a combination of 
two separate tones. One tone is determined by the row 
that the key lies in; the other is determined by the col- 
umn (see Figure 1). 

Program 6 generates random phone numbers, play- 
ing the accompanying tones. Do not hold your phone 
up to the speaker of your TV set while this program is 
running— you may end up with an expanded phone bill! 
HCM Glossary terms: Iteration, linear, noise channel, periodic noise, 
white noise. HCM 
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Program Listing 2: QUN FIGHT 
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Program Listing 3: MOTOR REV 
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Program Listing 4: HICCUP 
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Program Listing 5: SIREN 
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Program Listing 6: TOUCH TONES 



g 370 



FO 
GO 



EH 
A 



FOB 
HEX 
FOB 

SOS 



FOH 



GO 



ou 



T 
J DOM 

It 



3 
I 

SOU 
SOU 



so 
sou 

z 



1 = 



TO 



TP 





TON 



TO 



3 + S 



© Home Computer Magazine 1985 Volume 5, No. 6 



55 



_J 




1 11 "1 "11 



Debugging DOS Directory 
-Part 2- 




Last issue, we introduced you to the DEBUG.COM utility, which comes on the supplementary pro- 
grams disk of MS-DOS 2.10, and showed you how use it to manipulate the DOS directory . In this 
tech note, we continue with more tips on using DEBUG to alter the directory. 

If you don't include a /V parameter when you FORMAT a disk, the disk is unlabeled. Usually, there 
is no way for you to add a volume name from DOS — but there is with DEBUG. As we stated last issue, 
when you write to a disk using DEBUG, you could make a mistake that destroys the directory of a 
disk, making the files on the disk virtually unrecoverable, Therefore, exercise caution when modify- 
ing a disk, and don't use your only copy of a treasured disk — use a backup. 

Now, here's how you can add a volume name: 

(1) Place a disk with DEBUG.COM on it in the default disk drive (drive A), then type DEBUG and 
press [ENTER], You are presented with the DEBUG prompt— a hyphen (-). 

(2) Next, place the disk to which you will add the volume name in drive A, then type L 100 5 4 
to load the directory into memory. This command loads 4 disk sectors of the directory into memory — 
which is sufficient for most disks. If your disk contains 64 files or more, however, the directory will 
require more than 4 disk sectors. If this is the case, type a 5 in place of the 4 above. 

(3) Now, to view the directory (in groups of 4 entries) type D (for Dump) and press [ENTER). Con- 
tinue pressing D and [ENTER] until you see an entry like this: 

08F1;0200 00 F6 F6 FB F8 F6 F6 F6-F6 FS F8 F6 F6 F6 F6 F6 . vvvvvvvvvvvvvvv 

08F1:0210 F8 F6 F8 F6 FB FB F6 F8-F6 F6 F6 F6 FB F6 F6 F6 vvvvvvvvvvwwvv 

Available places in the entry are marked by a location containing a zero (00) followed by a series 
of F6s. The first location in which this occurs (200 in the example above) is where you will add the 
volume name. 

(4) Let's say you want to call the disk MYDISK. Following the example above, you would type: E 200 
and press [ENTER]. If the address on your disk is other than 200 (as is very likely), substitute the ad- 
dress where the zeros and F6s first appeared during the Dump. Now you are presented with this display: 

08F l:02i30 00* 

The cursor flashes just to the right of the period after the zeros. Here, enter the hexadecimal number 
corresponding to the ASCII of the first letter in the new disk name (refer to the hexadecimal/ ASCII 
chart below.) M is the first letter of MYDISK, so enter 4D (the hexadecimal for M). Next, press the 
Space Bar, and you will be taken to the next memory location that contains a F6, Here, enter a 59 
for Y, then press the Space Bar again. 

Continue in this manner until you have entered ait the letters in MYDISK. The DOS directory allows 
an 1 1 character volume name. You must fill in the rest of the volume name with blanks (hexadecimal 
20). In the twelfth character position, you must specify the type of file (the file attribute). Enter 08 
— the attribute of a volume name. Now, press [ENTER], and your changes are recorded in memory. 

(5) Next, make sure that the write-protect notch is uncovered on the disk, and type W 100 5 4 
to write the new directory with your volume name to the disk, then type Q to Quit DEBUG. Note that 
you must Write the same number of sectors that you originally Loaded. For example, if you Loaded 
with H00 5 5, you should Write with W 100 5 5 

Now when you get a directory of the disk it will contain the new volume name. 

The space character is not legal in a DOS file name. From BASIC, however, you can SAVE a file 
with a space in the name. You may then SAVE or LOAD a BASIC file using this illegal name, but 
you cannot delete the file from DOS using the DEL or ERASE commands, nor can you KILL the file 
from BASIC. By using DEBUG, however, you can make the file eraseable again. Follow steps 1 through 
3 above to run DEBUG, load the directory that contains the illegal file name, and locate the illegal 
file name with the Dump command. Then, use the Enter command to place any legal file name character 
in place of the space (such as a 41 for a capital A). Next, follow step 5 to Write the corrected directory 
back to the disk. Now you can delete the file. 

— Roger Wood 
HCM Glossary terms: ASCII, hexadecimal, sector. 
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Several Flags In One Variable 



Flags are an essential programming element. For most programs, you can keep each flag 
in a separate numeric variable. But as memory gets tight (a common occurrence if you are 
using a TI-99/4A without memory expansion, and your programming task requires many dif- 
ferent flags), you may wish for an alternative to this method. 

Well, here is a "trick in TI Extended BASIC that lets you keep several flag values in just 
one numeric variable! This method has two key elements: First, because a flag is binary in 
nature (yes or no, on or off, etc.), you must interpret the numeric variable as a binary quanti- 
ty. The other important part of this trick is using the TI Extended BASIC logical operators 
OR and AND to set, clear, and test (read) the various flag "bits ' in a variable. 

Before you can use one of the logical operators in this manner, you must first know the 
value of each bit within a binary number. The first chart below shows these values. 

For example, the decimal number Bit numtw: 7654 3210 

32 is a binary 0010 0000, and 34 is ^. va,w,: l ™ * 4 * \ 6 ? ? ? } 
a binary 00 1 00 1 . Therefore in an 
8-bit quantity you have 8 different flags — one for each bit. 

Let's see what effect logical operators can have on binary numbers. Both the AND and OR 
operators compare two binary numbers and produce a numeric result. 

To set a flag, use the OR operator. You can set a particular bit within a numeric variable 
by ORing that variable with the value of the bit to be set. The OR operator checks to see 
if a bit in the first number (the flag byte) is set or the corresponding bit in the second number 
(or mask) is set, If so, the OR operator sets that bit in the resulting number. The second figure 
shows the result of the operation 40 OR 12. 

Let's use the variable FL as an ex- 
ample. To set bit number 2 in FL do 
the following: FL = FL OR 4. To set 
bit number 3 do this: FL = FL OR 8. 

To clear a flag, use the AND operator. You can clear a particular bit within a numeric 
variable by ANDing that variable with everything but the value of the bit to be set. The AND 
operator compares two numbers; if a bit in the flag byte is set and the corresponding bit 
in the mask is also set, then the AND operator sets that bit in the resulting number. An 8-bit 
number holds a maximum value of 
255— all bits set. To clear just the Decln Jo "cT'o 10 1000 Fia* byte 

zero bit, execute the following: FL 247 1111 0111 Mai* 

= FL AND 254 (255 minus the value 32 0010 0000 R«uit 

of the bit to be cleared). To clear bit number 3, do this: FL = FL AND 247. The third figure 

shows the result of the operation 40 AND 247. 

Now that you can clear and set bits, how do you read them? You test a bit by ANDing it 
with the value of the bit that you want to read. To test if the zero bit of a flag is set or clear, 
do the following: RESULT = FL AND 1. To test bit number 3, execute this: RESULT - FL AND 
8. If RESULT ends up equal to zero, the flag is clear. If RESULT is a nonzero number, the 
flag is set. ^^ fl[ 

With the AND and OR operators, 40 0010 1 n* byte 

you can manipulate each bit L * «"*< 

separately. With this capability, you 8 0000 1 o R«*m 

can use each bit within a numeric variable as an independent flag. For example, you can 
use the zero bit in a variable to flag whether output should go to the screen (bit is clear) 
or the printer (bit is set). Bit number 3 can determine whether the program will use sound 
effects or not. 

— Scott Williams 

HCM Glossary terms: bit, byte, flag, logical operator, mask. 
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Problems 




With this new column and HCM productivity software, 
you can build solid decision-making tools. 



A CHALLENGE TO OUR READERS 

f n past issues, HCM has published a number of productivity programs as tools for making calculated deci- 
I sions. The Organizer for example, helps you prioritize and systematize your thoughts. And Snap-Calc lets 
I you adapt a simple spreadsheet for your own applications— for example, tracking Investments, comparing 
purchase options, calculating payroll, etc. 

"Problems in Productivity" Is a column designed to help you find new ways of using these productivity 
tools. Each issue, this column presents one "problem in productivity"— a real-life situation that cries out for 
a computer solution. You can solve all the problems by using one of our previously-published programs as a tool. 

Next issue, we will publish our own solution to the problem presented here, together with a new problem. 
You can then compare our solution to your own. 



This issue f s productivity problem calls for Snap- 
Calc. published in the Vol. 4, No. 3 {August, 1984) 
issue. Your challenge is to use this simplified 
computer spreadsheet to answer a question many 
families face every year: Where can we find the college 
education to best fit our financial situation? In solving 
the problem, you will learn more about spreadsheets 
in general, and Snap-Calc in particular. [At present, 
there is no version of Snap-Calc for the Atari 800 , 
800XL, or 130 XE. We will, however, make this ver- 
sion available soon— Ed.] 

Asking Questions 

How do you plan a college education? What frame- 
work can you use to compare all the financial alter- 
natives offered by all the different schools you Ye likely 
to consider? In Figures 3, 4, and 5, we give you a typical 
(but imaginary) choice between three different institu- 
tions. Although this data varies between colleges, all 
items reflect common expenses that any college student 
encounters. Your "assignment," should you choose to 
accept it is to develop a spreadsheet template for com- 
paring the three sets of data and computing a * 'bottom 
line" that indicates the best financial alternative. Next 
Issue, we will publish our solution: a completed template 
that manipulates the data in Figures 3, 4, and 5. 

Snap-Calc In Short 

What on Earth is a spreadsheet template? Put sim- 
ply, it's a framework of formulas used to study relation- 
ships between numeric "elements"— both constant and 
variable. In the old style of bookkeeping (handwritten), 
these mathematical comparisons were often confusing, 



time-consuming, and tedious. Every time one number 
changed, the bookkeeper had to refigure all the calcula- 
tions and make corrections. 

But with Snap-Calc, you can design a pre-set template 
of formulas and let the computer do most of the work. 
By entering raw data into the template, you can do a 
day's worth of bookkeeping in a few seconds. If one of 
your figures changes, you merely input the new 
number, and the computer recalculates all the formulas 
and complex relationships for you. This makes Snap- 
Calc a powerful "what if" tool, allowing for rapid com- 
parison of many different alternatives. You can use it 
time and again to test different options or hypothetical 
situations. 

Here's an example: Let's say you want to calculate 
the cost of your dream vacation this summer. Before 
you leave, create a template with Snap-Calc that enables 
you to list all your daily expenditures. Include columns 
for meals, hotels, plane tickets, rental cars, fuel, tips, 
and tours. You can then enter a formula that sums up 
these daily costs (either actual or estimated). Then by 
Incorporating a formula that subtracts your expenses 
from your available funds, you can balance each day 's 
expenditures. 

You may use this template either to plan a vacation 
that fits your budget— by comparing all the 
alternatives— or to keep track of your daily expenses 
while traveling. Figure 1 shows the information needed 
for such a spreadsheet, and Photo I shows what the 
spreadsheet would look like on-screen. 

For actual Snap-Calc operating instructions, see Vol. 
4, No. 3 (August, 1984) of HCM. If you don't have Snap- 
Calc with all its updates, see "DeBugs on Display" Vol. 



Figure 1 




LOGIC NAME IS TRIFCOST 


10 IS BREAKFAST 


TOTAL COLUMN IS 10 


11 IS LUNCH 


LAST COLUMN IS 9 


12 IS DINNER 


IIS DATE 


13 IS SNACKS 


2 IS CAR RENTAL 


14 IS ENTERTAINMENT 


3 IS GAS COST 


15 IS TRIPS 


4 IS GALLONS 


16 IS HOTEL ROOM 


5 IS ODOMETER START 


17 IS AIR PAIS 


6 IS ODOMETER STOP 


18 IS TAXI FARE 


7IS MILES 


19 IS DAILY TOTAL 


7 = 6-5 


19 = 2 + 3 + 10 + 11 + 12 + 13 + 14 


8 IS MILEAGE 


+ 15+16+17 + 18 


8 = 7/4 


20 IS RUN TOTAL 


9 IS COST/MILE 


20 IS 19 + LAG 20 


9 = 3/7 






Figure 1 stows each "Tripcost" formula 
numbered by row. Photo 1 shows a typical 
spreadsheet with entries 
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4, No, 5; Vol. 5, No. 1; Vol. 5, No. 2; and Vol. 5, No. 3; 
or order the Vol. 4, No. 3 ON DISK/ON TAPE. (Note: 
Snap-Calc on the TI-99/4A requires memory 
expansion.) 

Now Far The Challenge 

As mentioned, this issue's productivity challenge is 
to create a spreadsheet template that allows a com- 
parison between different college education alternatives. 
Here are some suggestions that will help you formulate 
your template: You will need gross income rows for the 
student, both parents, and income from other sources. 
(Gross income figures are used to analyze the student's 
qualifications and need for some types of student finan- 
cial aid.) You'll need 4 rows for expendable income. 
Make expense categories for tuition, housing and meals, 
books and supplies, transportation, entertainment, 
clothing, and vacations. 

You will need formulas that will sum the various 
quantities and subtract the expenses from the total in- 
come. (As you develop the spreadsheet, you will encoun- 
ter the need for other formulas to create subtotals, etc. 
If you need extra help, turn the page upside down and 
read "Hints.**) If the variance— the difference between 
income and expenses— is a positive number, the stu- 
dent can afford the particular college used in the para- 
meters. But, if total financial resources fall short of ex- 
penses (a negative variance), the student must qualify 
for financial aid to make up the difference, Try enter- 
ing different levels of financial aid. If you project that 
scholarships or grants would cover less than the vari- 
ance, add in available savings. And if this still doesn't 
cover the costs, examine other types of loans that allow 
low payments while the student is still in school. 

Keep in mind all the options available. You may even 
discover some options that we have not suggested. The 
example in Figure 5 assumes that the student starts at 
a community college, attends part-time, lives at home, 
and is working for funds to transfer to another institu- 
tion. But in this case, transfer procedures may require 
5 years— instead of 4— to complete the student's educa- 
tion. Also, as shown in Figure 4, if the student wants 
to attend an out-of-state school, additional costs for 
transportation and out-of-state tuition affect the total 
financial picture. 

Work first with the sample parameters and numbers 
provided in Figures 2, 3, 4, and 5. (These will appear 
in our published" "solution" next issue.) Then, you 
might try using other items and statistics you've ac- 
cumulated from researching real institutions that in- 
terest you. Changing figures and parameters— and then 
letting the program recalculate the results— will show 
you how flexible and useful a spreadsheet like Snap- 
Calc really is. 

HOI 



gure Sample Annual Income Base 




1st Year Income: 




Father's Gross 


20,000 


Mother's Gross 


16,000 


Student's Gross 


1,500 


Other 


1,000 


Father's Expendable 


1,500 


Mother's Expendable 


1,500 


Student's Expendable 


500 


Other 


500 


Savings Available 


500 


Loan costs 


7.5% 


Note: Income Increases 10% per year. 





Rfiure 3 College A 




(4 Years In State) 




1st Year Expenses: 




Tuition 


1432.50 


Meals & Housing 


1098.00 


Books & Supplies 


300.00 


Misc. Personal 


990.00 


Note: Expenses Increase 5% per year 





ngure 4 College B 

(4 Years Out of State) 
1st Year Expenses: 

Tuition 


4057.50 


Meals & Housing 
Books & Supplies 
Misc. Personal 


2340.00 
300.00 
990.00 


Note: Expenses Increase 5% per year 





F1 « ure 5 College C 




(2 Years Community College Then Transfer) 


1st Year Expenses: 




Tuition 


594.00 


Meals & Housing 


400.00 


Books & Supplies 


300.00 


Misc. Personal 


800.00 


Note: Expenses Increase 5% per year. 


For expenses after the 


transfer to either an In-state or out-of-state university (for 3 re- 


maining years), see Figures 3 and 4. 
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ASSEMBLING 
AN ALGORITHM 



by the HCM Staff 



WHAT IS AN ALGORITHM? 

An algorithm is simply a procedure— one that a program 
uses to complete a task or solve a problem. Flow diagrams 
and flow charts are handy tools for representing the steps 
in this procedure. Any program can be viewed as a col- 
lection of separate procedures. In this column, we focus 
on and explain one unusual or interesting algorithm that 
\s found in one of the programs we publish each issue. 



This issue's M Algorithm-A-Tricks" focuses on the 
NanoAssembler* Assemblers* by nature, require 
several complex algorithms, and the Nano- 
Assembler is no exception. The main job of any 
assembler, however, is to identify mnemonics and 
translate them into their machine-language equivalent. 
Here we discuss how the NanoAssem bier accomplishes 
this formidable task. 

Using a series of DATA statements, the program READs 
all the possible mnemonics into a string array— OP$( ) 
for example. Each element of the array stores one 
mnemonic. (Note that because Atari BASIC does not 
support string arrays, we must simulate them. We do 
this by creating a single long string that contains all of 
the different mnemonics, and then use the Atari com- 
puter's string manipulation operator to extract the 
mnemonic we wish to check for. For the purposes of this 
column, we will continue to use arrays as our example, 
but Atari users should refer to line 1 130 to see how the 
NanoAssembler simulates these arrays.) 

The secret behind this technique is the order in which 
the program stores the mnemonics; according to their 
numeric machine-language equivalent (their op-code 
value). For example, the ADD mnemonic has an op-code 
value of 0, so OP$(0) = "ADD". Similarly, because the STA 
mnemonic has an op-code value of 3, OP$<3)= "STA". This 
conversion method applies to all 16 mnemonics. 

Now, how do we use the OP$( ) array to convert a 
NanoEditor source code listing into machine language? 
Fairly easily. Using a loop, the program compares the 
mnemonic field of a line with each element of the OP$( ) 
array. The loop executes a maximum of 19 times— i.e., 
1 6 times for the 1 6 mnemonics and 3 times for the three 
assembler directives (ORG, EQU, DN). If the program goes 
through the entire loop without finding a match, an 
ILLEGAL OP-CODE error results. If the program does 
find a match, the loop counter provides the op-code 
value of the mnemonic. When the program finds a STA, 
for example, the loop counter equals 3, the op-code value 
of a STA. Figure 1 shows a flow chart of this loop. Note 
that the variable names in this chart do not necessarily 
reflect the actual variable names in each version of 
60 © Home Computer Magazine 1985 Volume 5, No. 6 



From mnemonics to numbers: 
How does an assembler do it? 



NanoAssembler. We have chosen these names purely 
for explanatory purposes. 

The Number Of Nibbles 

Once the program has decoded a mnemonic into its 
op-code value, it must alot space for the op-code in 
memory. Not every op-code instruction demands the 
same number of nibbles. We therefore use another 
array— the NN( ) array (Number of Nibbles) to keep track 
of this amount. Set up in the same order as the OPS( ) 
array, this array stores the number of nibbles that each 
op-code instruction requires. For example, to find the 
number of nibbles that the STA instruction requires, you 
can print NN{3), with 3 representing the op-code value 
of a STA. 

HCM Glossary terms: assembler, mnemonic, nibble, op-code. 

HCM 



Figure 1 




OPCODE = CO LINT 



HCM ONE-LINERS 



SI 



Here they are . . . the best of the one-line programs that we have received since printing the 
fifth "HCM One-Liners" column in Home Computer Magazine Vol. 5, No. 5. Although many 
interesting programs were submitted, we have selected what we felt were the best 6 of those 
that arrived prior to this issue's press date (one for each brand of computer covered in our magazine, 
including a Tl BASIC "10 liner"). If you have not yet submitted your masterpiece, it is not too 
latel As long as we keep getting great one-liners written in any computer language, we'll keep 
filling this page for you. Our prize winners this Issue will each receive a check for $50 for sharing 
their ideas with our readers. 



Pixel Palette 

[TI Extended BASIC 
on the TI-99/4A] 
Dear Sir: 

My TI-99/4A one-liner lets you use a 
joystick to draw on the screen. You can 
design geometric configurations, let- 
ters, and numbers. To RUN this one- 
liner enter CALL CLEAR :: RUN. Make 
sure that ALPHA LOCK is up. The pro- 
gram displays your row and column 
position at the bottom of the screen. 
Type in the program until you hear the 
input beep, press [ENTER], then [FCTN 
8], and finish typing the program in. 
Robert Amenta 
New City, NY 



AH 



Two By Two 

[Commodore 64 BASIC 
on the C-64] 
Dear Sir: 

Here is a one-liner that allows limited 
word-processing. You can print two 
screen lines at a time, pressing 
[RETURN] after every two lines. You can- 
not use the comma, colon, or quotation 
marks. It works with most printers. 
Chris Caldwell 
Paris, TN 
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Mandate 

[Applesoft BASIC on the 
Apple II family computers] 
Dear Sir: 

This program creates oval patterns 
oriented around the center of the 
screen. With each plotted oval, the col- 
or alternates between black and white, 
forming an intricate design that covers 
the entire screen. 

Andrea Sigurdson 
Sidney, BC Canada 
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Sum It UP 

[TI BASIC on the TI-99/4A] 
Dear Sir: 

My great 10-liner is called the 
Add/Subtract Calculator. When you 
first RUN the program, the "Totals" 
value is 0. You can add to this value by 
selecting 1 then entering the number 
you wish to add, or subtract from it by 
selecting 2 then entering a number. 
Press [ENTER] and the screen clears, 
showing the new "Totals" * value. 

Richard Lin 
Moberly, MO 
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[NOTE: Because of built-in line length limita- 
tions in TI BASIC, we are now accepting "Ten- 
Liners" as entries for this column in a newly 
established TI BASIC category— Ed.] 
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Flying Fingers 

[BASICA on the IBM PC, 
Cartridge BASIC on the IBM PCjr! 
Dear Sir: 

Here's a quick, little one-liner that 
will get your fingers flying in no time. 
Qwiktype lets you set the time for each 
practice session and keeps a running 
total of right and wrong answers as you 
type. It displays wrong answers as 
negative numbers. If you find that the 
program is displaying all negative 
numbers— no matter what you 
enter— hit [Caps Lock]. Qwiktype re- 
quires DOS. 

Bob Langill 
Hillsboro, OR 
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Topsy Turvy 

[Atari BASIC on the Atari 800,800 
XL, and 130 XE] 
Dear Sir: 

This unusual one-liner turns the 
characters on your screen display 
upside-down. It takes a while to RUN, 
but it's worth the wait. 

Thomas Zaninovich 
Pittsburgh, PA 
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Afl One-Liner submissions are subject to the same publishing criteria as Letters to the Editor (explained in the 
magazine's masthead, page 6J. If you have written a great One-Liner in any language on any computer covered 
by HCM, send it addressed to: Letters to the Editor, 1500 Valfey River Drive, Suite. 250, Eugene, OR 97401 . You 
too may win a cash prize and be immortalized in print! 
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Apple Attack 

Corporate Image Tarnished 
As Firm Sues Ex-Chairman 



Will Sales Of New Add-Qns, 

Drop In Holiday Prices 

Help Give Stock More A-Peel? 

A tarnished corporate image, an unsteady 
financial picture, cutbacks, and legal saber- 
rattling now characterize the new Apple Corp. 
New product campaigns and improved fourth- 
quarter Financials fail to wash away the spec- 
tacle of Apple suing co-founder Steven Jobs. 
Apple filed suit against Jobs— who split from 
the company he co-founded, talcing 5 key 
employees— for breach of fiduciary trust. 
Meanwhile, Apple itself may be facing some 
litigation: Three publishers of recently released 
books about MacBasic may file suit against 
Big Red for cancelling the new language— 
and licensing the code to Microsoft to incor- 
porate in its own version of BASIC for the 
Mac— prior to MaeB ASIC's long-awaited 
release. But the beleagured Apple is not desert- 
ing its new corporate image. Dropping its 
"Macintosh Office" marketing approach, the 
firm says it will stick with its already developed 
office peripherals. The new 20 megabyte hard 
disk drive, a forthcoming file server, and 
various third-party items linking Mac to the 
IBM PC could help carve a large enough spe- 
cialized office niche. But Apple will also push 
its graphics-intensive Mac into vertical 
markets— such as desktop publishing. A new 
Mac keyboard, color monitor, "open chassis" 
Mac, Apple II/Mac cross-compliler, and 
reduced-price Laser printer are expected for 
1986 debut. Among recently released products 
for the Apple II are a 3 1/2" disk drive for 
$299, compact 1200-baud modem for $399, 
and a combination color/monochrome 
monitor for $399. A memory expansion card 
that will increase the Apple He all the way up 
to 1 megabyte is forthcoming. 

Ironically, the scuffle with Jobs and others 
may be drawing attention away from these new 
toys— just when the holiday season is hitting. 
Yet, Apple has cut the Mac 5 1 2K price by $300, 
bundled Apple II family products to create 
below-$1000 systems at retail, and revived its 
holiday ad campaign in a bid likely to lift 
Christmas sales. 



"QUOTABLES" 

"We believe the leading edge is often 
the bleeding edge in this business." 

-^Jaines J. Edgette, 
ofEntre Computer Centers, Inc., a retail chain that 
is reportedly not stocking Commodore's Amiga. 



What's News 



<S> 



Tandy Corporation's success with its $1000 
PC-compatible family is spurring it on to 
smaller and better things— a 16-bit laptop 
machine with 3 1/2" disk for $1595. Watch 
for holiday bundling of color monitor with 

model 1000 at same $1000 price. 

* * * 

"Shrink Wrap" laws, like the one recently 
passed by Illinois, may put copy-protection 
"under wraps." Under such legislation, now 
being considered by several states, the act of 

opening a software package implies agreement 
to copyright conditions. Detractors fear this 

could weaken consumer warranties. 

* * * 

Digital Research buckled under Apple legal 
pressure to make its GEM format more 
"distinguishable" from Mac programs. IBM 
also ruffled DR's feathers by announcing it 
wouldn't sell GEM as earlier planned. Apple 
may threaten suit against other Mac lookalikes 
for "visual copyright" violations. 



A complete encyclopedia on one compact 
laser disk by Grolier, Inc. will soon sell at $199 
(for the IBM PC and Atari ST). Requiring a 
CD-ROM drive and interface ($500-1000), the 
medium provides super fast data search and 
full cross-indexing of its 9 million words— a 

real home computer advantage. 

* + * 

Old soldiers never die . . . TexComp has 
premiered a 128K 99/4A-compatible, while 
Franklin has announced a new Apple II- 
eompatible with an operating system that 

reportedly meets Big Red's legal scrutiny. 

* * * 

Big Blue strikes again. IBM has pulled off 
a major coup— recently signing a deal giving 
it access to several hundred high-tech Japanese 
patents for advanced optical and chip 
technology. The deal stems from patent- 
licensing access IBM gave Japan after World 
War II, and is predicted to give IBM an un- 
precedented technological edge. 



IBM Hanging Tough 

PC Sales Hold Constant 
PCjr Gets Push 

Pact With Microsoft 
Promises Stability 

Sales of both the IBM PC and the XT are 
holding steady during the market shakeout, 
while Big Blue has reaffirmed its commitment 
to the PC line's open architecture— recently 
agreeing to continue the reign of Microsoft's 
PC-DOS, rather than revert to a once-rumored 
proprietary operating system. This is good 
news for both third-party developers and those 
who use their products. Some skeptics think 
this is merely a ruse to buy time until IBM can 
issue a new closed-DOS 80386-based machine. 
The facts suggest, however, that IBM will pro- 
bably have Microsoft revamp their Top View 
software, and fold MS-Windows into it. 

Inclusion of a 30 Mbyte hard disk on the 
AT for a mere $200 increase in cost over the 
20 Mbyte "garden variety" version may fore- 
shadow yet another round of price cuts for all 
IBM personal computers. Meanwhile, expect 
another PCjr Christmas. With the street price 
of Junior with color monitor around $599 and 
special promotional offers to schools, the 
estimated 300,000-unit inventory should be 
cleaned out by early spring— just in time for 
the possible U.S. introduction of the Japanese- 
introduced (and Australian test-marketed) JX 
model with 3 1/2" disk drive. 



Commodore Stniggles 

Firm Still Clinging 

To Amiga's Potential Success 

But Will New Model 
Be A True Friend? 



Commodore is suffering. Doomful com- 
pany predictions foretell an $80 million loss 
in the firm's fourth quarter, a layoff of 700 
employees, and a $50 million inventory write- 
down. Commodore executives are counting on 
Amiga to bring the company out of its slump. 
The firm hopes that the new computer, billed 
in a scheduled $40 million dollar ad campaign 
as the "Creative Edge," will return the com- 
pany to solid financial ground. 

But Amiga may not be enough. Analysts 
speculate that Commodore's home market im- 
age, its unreliable reputation, and lack of 
distribution will be impossible to overcome- 
even though a national ad has listed 662 dealers 
ready to handle the new computer. And Amiga 
has problems of its own: Its late arrival and 
lack of software development— in part due to 
an incompletely defined operating system- 
weaken its holiday appeal to all but a dwin- 
dling supply of "early innovators." 

Commodore's unexpected success in dealer 
sign-up may be attributed to its single-level 
pricing structure and lack of purchasing 
volume requirements— a lure that allows stores 
of all sizes an equal chance to compete, while 
discouraging gray marketeering. 
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Trouble In Atari-Land? 

Two Top Execs Make Tracks 
Firm's Fate Rests On ST 



Will Apple Grab Jackintosh 
By The GEMs? 

Dealers complain of too^ight sales condi- 
tions, others worry about lack of software, still 
others wonder if Atari's funds will hold out— 
but Jack Tramiel keeps touting in print ads 
his $799 520 ST— dubbed the " Jackintosh"— 
as the "Rip-off Buster.*' Atari's future hangs 
on this new machine— for which it now claims 
to be shipping a BASIC language after long 
delay. With uncertain cash reserves, the firm 
doesn't seem to have much more time. Mean- 
while, amid rumors of mismanagement by 
Tramiel, Atari lost two top executives. 

But there is a new question: Will Macintosh 
sink Jackintosh? The answer may lie more in 
legalities than kilobytes— if Apple brings its 
legal guns to bear. Atari's 520 ST earns its 
nickname from its Mac-like GEM environ- 
ment. By its settlement with Digital Research, 
the developers of GEM, Apple has forced ma- 
jor changes to GEM Desktop, Draw, and 
Paint. A similar suit against Atari might delay 
the ST enough to empty company coffers. Sam 
Tramiel says, however, that DR has only 
agreed to "certain superficial changes"— and 
that, "Contrary to reports, the agreement does 
not require changes to GEM [itself] or to Atari 
Corpus TOS operating system." 
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Software Market Trends 

Firms Merge 

Drop Protection, Prices 

Site-Licensing The Norm 
In Corporate America 

Consolidation, lower prices, less copy pro- 
tection, and more site licensing typify the now- 
more-mature software industry. Borland In- 
ternational is a case in point; Immediately after 
Borland recently acquired Analytica, makers 
of the Reflex database, it slashed Reflex's 
price— from $495 to $99— and eliminated its 
copy protection. Borland will now also offer 
site licensing for its best-selling Sidekick desk 
accessory software package, whereby— for 
$50,000— large corporations can make 
unlimited program copies. 



Cyber Communications 

High-Speed Modems 
Head Movement 



Are Sci-Fi Videophones 
Just Over Horizon? 

New high-speed modems of 2400 baud and 
beyond, more powerful telecommunications 
chips, and network-creating alliances like the 
recent IBM and MCI merger are laying the 
groundwork for the long-awaited communica- 
tions revolution. 

IBM is working toward a full voice, video, 
and data distribution network— perhaps lead- 
ing to a method of receiving voice-read data 
from a personal computer over the phone. 
Epson has teamed with ABC to send electronic 
mail over FM radio. Meanwhile, go-it-alones 
like GTE with its Sprint service are expected 
to be at a severe competitive disadvantage. 



Printshops Beware 

Desk-Top Publishing 
Becomes Viable Alternative 



Explosion of Lasers, 
Versatile Pagination Software 

Computers with super printers now make 
it possible to publish near print-quality 
material from a desktop. Full-up systems with 
adequate memory and powerful software are 
already here— at prices that are convincing 
large numbers of firms to bring the function 
"in house." Analysts expect rapid hardware 
advances in resolution, color, and speed, plus 
software featuring auto-hyphenation and 
easier-to-use "human interfaces." Newer 
printer technologies will slug it out with the 
now-dominant laser print engine, Ricoh is 
rumored to be introducing a five page per 
minute, under-$1000 machine by year end. 



THROUGH THE LOOKING GLASS 



Artifical Intelligence Gives Expert Advice As 
Machines Gradually Become More Human 

Computer, computer, on the wall— what's the best choice for us all! 
If your computer could make decisions for you, would you consider 
it intelligent? Would you settle for some good advice? Some of us 
may expect much more — like self-awareness and creativity — from a truly 
intelligent machine. But at the current state-of-the-art, what we can get is 
expertise. Knowledge-based or * 'expert" systems are popping up all over, 
finding use in management, on the assembly line, and in ever more applica- 
tions for personal computers. These software systems provide advice in 
reponse to real-world questions like "What do I do now? The thingamajig 
won't budge!" Instead of a whole set of instructions, 
you get the kind of measured, specific advice you would 
expect from an engineer looking over your shoulder: 
"That doesn't work? Try this . /' 

But say you want to discuss the meaning of the universe 
with your computer. You may find that the machine is 
not so dumb as it is ignorant. Expert systems are limited 
by processing speed, memory, and storage capacity — so 
naturally the average 128K home computer will not pro 




vide very quick decisions, or have much to base its advice on. Most useful 
systems need megabytes of data in memory and on hard disk or CD-ROM. 
They must be able to search through an immense set of alternatives for every 
possible situation in the knowledge base, then narrow all these down to the 
correct choice. Obviously, the universe is a very immense set of alternatives 
for anyone to handle — including the smartest computer. But "full-up" systems 
consisting of a personal computers with super expansion cards, hard disk 
drives, and CD-ROM capability are quickly becoming more affordable. In 
situations that demand specific expertise, such as fixing the widget on your 
automobile, artificial intelligence is coming home. 

As we build smarter systems , human-like intelligence may yet come to 
machines— perhaps to make many important decisions for us. Now may 
be the best time to start deciding what decisions we will want them to make. 
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Of Music and Microchips 

by Andy Widders-Ellis 

HCM Staff 

Hark! Does the sound of electronically-produced music 
herald the next stage in the evolution of the personal computer? 



It's a fact: Personal computers have permanently 
changed the way people produce music. The impact 
of this technology can be heard all around us. 
Curiously, the other side of the coin is often 
overlooked— how music has stirred up the world of 
home computers . . . 

Heresy! 

Music has been around a long time, and— let's face 
it— humans would have continued to express 
themselves through sound with or without the elec- 
tronic revolution of the 80s (albeit in much more tradi- 
tional ways). Music benefits tremendously from the 
home computer, but doesn't require it to stay vital. 

On the other hand, what about the field of home 
computing— hasn't evolution been necessary for some 
time now? How many personal computers are gather- 
ing dust because their owners lack some deeper, satis- 
fying long-term involvement with them? 

Home computers have the reputation of drawing the 
user into isolated, solitary activities. We all know the 
typical stereotype: A computer user spends a lot of time 
alone— apart from family and friends— playing games, 
keeping books, studying, word processing, etc. Of 
course, most of us need some time alone, simply for 
peace of mind and mental health. An activity that allows 
us to work in reflective seclusion can be valuable. 

But how much more valuable is a hobby that pro- 
motes both private time and together time? Computer- 
assisted synthesizer programming, composing, arrang- 
ing, sequencing, and editing does necessitate working 
by yourself. Yet, once a creative project is complete, the 
musical fruits of this labor practically demand to be 
shared. Ultimately, music deserves an audience— the 
obvious thing to do once you've created your music is 
to let someone hear it. 

Out Of The Closet 

We are witnessing a renaissance: Once used as fancy 
calculators, game players, and effective but utilitarian 
business machines, personal computers are now 
becoming creative tools for personal self-expression. 
Thanks to this creative potential, inspiration for work- 
ing with home computers is re-kindling. Home com- 
puters are emerging from the closet to appear in the liv- 
ing room again. Why? Because folks want hobbies and 
pastimes that they can develop over a lifetime, and that 
yield useful skills in exchange for the energy invested. 
To date, few computer activities have offered this much 
long-term, open-ended growth potential. 

Also contributing to the rejuvenation of the home 
computer is the new owner who was never interested 
in mere "computing." These first-time buyers— at least 
initially— have one application in mind, namely music. 
64 © Home Computer Magazine 1985 Volume 5, No, 6 



It will be interesting to see whether, in time, these people 
find other uses for their computers. 

What's It All About, PC? 

If you subscribe to the theory that many of mankind's 
noblest ambitions and achievements are in the realm 
of communication, then something that supports this 
effort becomes very precious. Since the dawn of civiliza- 
tion, music has manifested this power to bring people 
together. We know man-made sounds can heal or 
wound, create or destroy, excite or soothe, elevate or 
depress. Cruise the radio dial to confirm this! 

The point is this: Home computers place this power- 
ful means of self-expression— once monopolized by a 
trained elite— into more hands than ever before. If you 
own a home computer, then you can wield previously 
unheard of control over this potent force. Doesn't this 
realization make the thought of playing "just another 
video game" seem a tad tame? 

Knock On New Doors 

The old notion that musical expression is for a chosen 
few no longer applies. With today's technology, you can 
compose and sequence wonderfully complex and de- 
tailed music with only one fingerl If you have musical 
ideas, they can be realized using a home computer and 
computer-based electronic musical instruments to carry 
out the physical task of real-time sound production. 
Computers force us to redefine the term "musician." 

Musical self-expression is within your grasp, even if 
you are a novice, Sure, you have to work at it— creative 
expression takes persistent effort. But the rewards 
justify this effort. As you gain knowledge and experience 
in music, you will come to see both yourself and your 
computer in a new light. Self-expression is satisfying 
and liberating, as therapists will attest. And the instru- 
ment that facilitates this creativity becomes especially 
important to the user. 

A new generation of computers is emerging, combin- 
ing greater sophistication, super hi-res graphics, and 
more power— with lower cost. These features make 
them ideally suited for use as creative tools. The new 
Atari 520 ST even comes with a built-in MIDI {Musical 
Instrument Digital Interface) port! Obviously, Atari is 
counting on musical applications to enhance the value 
of its new product. 

Turn On, Tune In, Take Off 

As our acknowledged universal language, music has 
accompanied (and often shaped) the unfolding drama 
of man. Why not come "on line" with your own con- 
tributions? A home computer can be your ticket to this 
creative journey. Who knows what you'll discover? 

HCM Glossary terms: MIDI. HCM 
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The Compact Home Music Studio 



Home Computers: New Dimensions in Musical Participation 



Synthesizer Soundings & Digital Orchestration 



Stretch Your Tape Recording Dollar: 



Affordable Multi-Track Cassette Equipment & Techniques 



Featuring a Dound-ln Sound Demo Record 

PLUS— A Free Set of 

Soundpatch Library Cards 
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USIC & . 

Electronics 



The Magazine of Creative Discovery Through Sound Technology 

Music & Electronics is devoted to "the musician in all of us." Each issue explores the many facets of personal music creation, 
performance, and education through the magic of computers and electronics. Editorial content spans a full range of subjects— from 
creating the Electronic Orchestra by interfacing musical devices with home computers, to analog and digital recording tech- 
niques, to computer-assisted music lessons. Bound into each issue is a Soundsheet demo recording, adding an extra dimension 
to magazine content, and an assortment of Soundpatch Library Cards for re-creating unique sounds on current musical devices. 
Each 1-year Mus/c & Electronics subscription includes 6 magaane issues, plus 6 companion audio cassette tapes which provide 
in-depth audio examples directly relating to the magazine's tutorial articles and in-depth reviews. 



Electronic Music Lab™ 

Basic Principles of Music Synthesis 
What is this thing called sound? What dis- 
tinguishes one sound from another? How is 
sound created electronically? We answer these 
and many more questions in this basic primer on 
the physical phenomenon of sound and synthesis. 
Our clear explanation of this medium takes the 
mystery— but not the wonder— out of the new 
musical technology. 

Synthesizer Soundings™ 

Hands-on Lessons 

Here we demonstrate how anyone can "pro- 
gram" the most popular synthesizers. It's not just 
a matter of moving switches and pushing but- 
tons, M & E's mandate is to teach the art of 
sound design. 

The Digital Sampler™ 

From Physics to Numbers and Back 
Digital recording is a fundamentally new way of 
capturing sound. Home computers can play a role 
in handling and manipulating this musical data. 
Learn how to work with this new technology, as 
M&E takes you along the digital path. 

The M&E Soundpatch Library™ 

Ready-to-Use Synthesizer "Patches" 
Looking for new and useful sounds on your elec- 
tronic instrument? Each issue contains easy tear- 
out cards with original patches for popular syn- 
thesizers. When appropriate, soundpatch data 
from the magazine will also be available on tape 
or disk. 

Computer Home Companion™ 

Home Computers and Music Magic 

Home computers— some of which have small 

built-in synthesizers— are opening up the flood- 



gates to popular participation in the creation and 
performance of music. Some software teaches 
music theory— while other programs convert the 
computer into an instrument itself. M&E also 
shows readers how computers can record and 
control musical devices. 

The Home Musk Studio™ 

The Art of Analog <£ Digital Recording & Mixing 
Miniaturization and cost-reduction of electronic 
instruments, computers, and recorders have made 
compact, affordable home studios possible, In 
this series, we help you develop your own record- 
ing system— providing tips on design, construc- 
tion, and operation, as well as advice on select- 
ing the proper equipment. Learn multi-track and 
MIDI recording techniques, signal processing 
tricks » and how to achieve professional results 
from your personal studio. 

M&E Rhythm Beat™ 

Programming Digital Drum Machines 
Drumming has changed radically since Ringo 
struck up the band. Today, even those who never 
mastered the sticks can program a machine to 
both imitate drummers and play humanly im- 
possible "licks." The digital drum machine is an 
extension of the traditional drum set— for which 
rhythmic skills are essential. Learn the rudiments 
of rhythm; enjoy lessons in style; explore the 
world of the big beat. 

MIDI Melting Pot™ 

Plugging into the Industry's 
Common Communications Standard 
MIDI (Musical Instrument Digital Interface) is 
an industry-standard interface that sends musical 
information in digital form between synthesizers, 
signal processors, and computers. This interface 
can link many electronic music devices in one 



large ensemble , or connect the synthesizers and 
signal processors to a computer for digital record- 
ing and editing. Learn how MIDI is indeed the 
key to the Electronic Orchestra. 

Composer's Workshop™ 

Creating & Arranging a Musical Idea 
Electronic instruments make it easy to write and 
arrange music, even for those with little or no 
previous experience. Let M & E show you how 
to generate and develop ideas— bringing your 
music out of the shower, into the streets. 

In Session™ 

The Making of a 'Track" 
Listen to the bound-in sound recording, then 
follow us as we document the entire recording 
and mixing process step-by step, using text, 
diagrams, and color photographs. 

Pro-Formance Playbill™ 

M & E's beat covers the exciting world of 
electronically-produced music through interviews 
with major artists plus reviews of concerts and 
new releases. 

M&E Review Roundup™ 

M&E provides incisive reviews of electronic 
musical instruments and equipment plus in-depth 
analysis of the latest software products* 

Ask MsE™ 

Here our readers get to sound-off with any ques- 
tions related to electronics and music. 

And There's More: 

* Create-A-Sound Contest™ 

* Compact Disk Corner™ 

* New Products Soundcase™ 

* Notes to the Editor™ 

* M & E Glossary & Abstracts™ 



—Plus a few special surprises 



VFC f Enclosed is $32 - 97 (Canada: $39.97) in U.S. funds. 
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AN AUDIO-VISUAL SPECIAL 

For Charter Subscribers* 

DON'T MISS OUT ON THIS 

EXTRAORDINARY SUBSCRIPTION VALUE! 

Featuring: 

• 6 magazines PLUS 6 companion ON TAPE™ cassettes 

m Unique performances from the latest electronic musical instruments 

• Demonstrations of step-by-step recording techniques 

• Lessons on creating original synthesizer sounds 

• An audio odyssey through M & E's popular columns: 

'"Composer's Workshop" and "In Session" 



Account No, 
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The Vol. I No, 1 Premier Issue of magazine 
and cassette tape will be malted In December 



1 



Signature 
I 



Enclose payment or credit card Information & mail with completed form to: 

Emerald Valley Publishing Co. • P.O. Box 70268 • Eugene, OR 97401 
Or use our TOLL-FREE Order Line for VfSA/MasterCard orders only: 

1 -800-828-22 t 2 In Oregon. Alaska, Hawaii Tel, (503) 485-8796 




Satisfaction Guaranteed— or the unfilled portion of your subscription will be refunded. 
Prices subject to change without notice, 



•NOTE; 

if you have already subscribed 
(o the magazine alone (no longer 
offered), we extend to you the 
opportunity of adding the dif- 
ference (SI 4.97 in U.S.) in 
charter rates to convert over to 
the full audio-visual companion 
package of 6 ON TAPE™ 
cassettes— for an additional 
SI5 savings! 



HOME COMPUTER 

Ihhhbhk InHproduct news ana 



Each month we publish items of interest and 
news of recently or soon-to-be released computer 
products. Our publication of information from 
manufacturers of computers, peripherals, software, 
and accessories is not to be construed as product 
endorsement. Prices quoted are the manufacturers ' 
suggested retail prices and are subject to change. 

Send press releases to: 

Product News Editor 

Home Computer Magazine 

1 500 Valley River Drive., Suite 250 

Eugene, OR 9740 t 
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Add A Data Warehouse 



New Apple II Drive Stores 800K 



Apple's new UniDisk 3.5" 
floppy disk subsystem 
substantially expands the 
data-storage capacity of 
the Apple II + , lie, and Ik. 
The system requires 3.5", 
double-sided disks that pro- 
vide BOOK of storage. 
Unidisk can be used in con- 
junction with other Apple II 
drives. UntDIsk also loads 
and saves data 50 percent 
faster than conventional 
Apple drives. It connects 
directly into the back of the 
lie or into an interface card 
for the, II + and lie. The disk 

Apple Computer, Inc. 
20525 Marian! Ave, 
Cupertino, CA 95014 
<408> 996-IQIO 
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drive is available for $499. 
(UniDisk on an Apple II + and 
lie, requires an Apple lie Ac- 
cessory Kit, which sells for 
$69.) 



Courtroom or Castle? 



Two New Adventures Released 

Telarium recently released 
two interactive adventure 
games. In Perry Mason: The 
Case of the Mandarin 
Murder, users play the role 
of Perry Mason, performing 
all the duties of a real court- 
room lawyer (cross- 
examining, introducing 
evidence, and consulting 
privately with the judge). In 
Telarium Corp. 
One Kendell Square 
Cambridge, MS 02 I 39 
(617) 494-1 2 OO 



Nine Princes in Amber, 
users try to capture the 
throne of Amber. Negotia- 
tion, politics, and alliances 
are key in this game. Com- 
modore 64 and 1 28 ver- 
sions are available for 
$32.95, IBM PC, PCjr, and 
Apple II family versions are 
$39,95. 



♦> ♦> ♦> ♦> 



Just Plug it In 



PC Hardcard Boosts Productivity 



Plus Development has in- 
troduced the first hard-disk 
drive on a plug-in board for 
the IBM PC. The Hardcard is 
designed to help PC users 
achieve the productivity 
gains of hard disks without 
losing their current invest- 
ment in the PC. It comprises 
a lO-megabyte disk drive 
and installation software on 
a plug-in card (measuring 4" 
x 1 3" x 1 *'). Hardcard does 
not require the repeated 
use of installation software 

Plus Development Corp. 
1778 McCarthy Blvd. 
MUpitas, CA 95035 
(408) 946-3 700 




and comes with Hardcard 
Directory, a program that 
allows users to locate ap- 
plication programs and data 
files on their hard disk. 
Hardcard will be available 
for a suggested retail price 
of $ 1 ,095. 



♦:♦ ♦> ♦:♦ ♦:♦ 



What's the Capital of , 



Educational Software for the 99/4A 



Trinity systems has in- 
troduced USA States and 
Capitals, an educational 
game for the TJ-99/4A. The 
object of the game is to 
identify more states and 
their capitals than your op- 
ponent. Players win points 
for each correct letter they 
type in as part of their 
Trinity Systems 
1022 Grand view Ave. 
Pittsburgh, PA 1S237 
(412) 366-581 1 



answer. The game also has 
a Tutor Mode, which in- 
dicates each state's location 
on the map, then displays its 
name, capital, and nick- 
name. The cassette game 
runs in TI BASIC and re- 
quires no additional soft- 
ware or memory. It retails 
for $ 1 2. 



♦> ♦> ♦> ♦> 



Mount-In Mega Memory 



Expansion Card For Apple II Family 



Apple plans to soon release 
a new Apple II Memory Ex- 
pansion Card for the Apple 
II, II + , and lie. The card ex- 
pands memory in 256K in- 
crements to over one 
megabyte, permitting 
Apple Computer, Inc. 
20525 Marian! Ave. 
Cupertino, CA 95014 
(408) 996-IOTO 



larger files. The card in- 
cludes RAM, ROM, and a 
custom integrated curcuit. 
The Memory Expansion 
Card's suggested retail 
price has not yet been 
announced. 



♦:♦ ♦:♦ ♦:♦ <♦ 
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Color Plotter "Solution" 




Keychart Gets to Core of Apple Graphics and More 



Softkey Software Products 
has rebuilt Keychart — a 
business graphics pro- 
gram — to operate on the 
Apple II, lie, and lie. The 
Apple-compatible program 
features on-screen layout 
preview capabilities and 
supports more than 20 dif- 
ferent plotters and printers, 
including those manufac- 
tured by Hewlett Packard, 
Houston Instruments, and 
Apple. Keychart produces 
combination bar, line, sym- 
bol, pie, X-Y, horizontal bar, 
and scatter charts from 
data compiled on Lotus 

Softkey Software Products, Inc. 
1 8480 Decatur Dr. 
Monte Sereno, CA 95030 
C408) 395-1974 



1 -2-3, Symphony, Super- 
Calc, Visicalc, MulttPlan, and 
Framework. Versions of 
Keychart are also available 
for the IBM PC, AT, XT, 
PCjr; IBM compatibles; and 
Texas Instruments Profes- 
sional. It sells for $375. 



♦ ♦ ♦ ♦ 



Four Years in the Wings 



Super Pascal Developed for Commodore 



Abacus Software has 
released a complete Pascal 
Development System — 
Super Pascal — for the Com- 
modore 64 and 1 28. Super 
Pascal utilizes a file editor, 
an assembler for coding-in 
machine language routines, 

Abacus Software 
P.O. Box 721 1 
Grand Rapids, Ml 495 10 
(616> 241-55 10 



a utility package for file and 
disk management, high- 
precision 1 1 -digit arith- 
metic, and high-speed DOS, 
The package, which includes 
a 200-page handbook, sells 
for $59,95. 



♦ ♦ 



♦> ♦> ♦> ♦> 



Carrying a Heavy Load 



Big-Byte Disk Drive for Atari 

Astra System's newest 

| disk drive, the Big D, is a 

double-sided, single- or 

double-density dual disk 

| drive for Atari computers. 

Big D is supplied with the 

latest version of TOPDOS 

and can store 720K. It's 

compatible with Atari's 

new XE Series, as well as 

Atari's intermediate com- 

| puters— the 400, BOO, 

Astra Systems, Inc. 
2500 Fairview, Unit L 
[ Santa Ana, CA 92704 
(714) 549-2141 



600XL, 800XU and 
1 200XL. Astra also makes 
two other Atari-compatible 
disk drives — the 200 1 and 
the 1 620. Both are supplied 
with SMARTDOS or 
MYDOS and can store 
360K. The Big D has a sug- 
gested retail price of $595. 
The 200 1 is $495, and the 
1 620 will be closed out at 
S300. 



♦ ♦ 



Hang On To Your TI 



Software Combines PC and 99/4A 



Intelpro has introduced Up- 
wards!, a new product 
designed to quickly transfer 
data between the TI 99/4A 
and the IBM PC, The 
package includes two pro- 
grams that run concurrent- 
ly on both computers, so 
that the TI serves as a 
"remote file server,'* 
transferring data at a rate 
of 8,000 characters per 
minute. The product re- 
quires a fully configured Ti 

Intelpro 

5325 Baillargeon St. 
Brossard, Quebec, Canada J4Z 
(SI 4) 656-8798 



99/4 A, an Extended BASIC 
cartridge, an IBM PC with at 
least 1 2SK of memory 
(256K is recommended), 
DOS 2.0 or 2.1 for the IBM, 
RS-232 capabilities for both 
computers, and a cable to 
connect the two com- 
puters. Upwards! has a sug- 
gested retail price of 
$ 79.95 for U.S. buyers and 
599,95 for Canadian 
buyers. 



1T1 
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MIDI Meets TI 



New World Class MIDI Software For 99/4A 



World Class Software 
unveils TEX-SEQ, a MIDI 
(Musical Instrument Digital 
Interface) sequencer 

package for the T1-99/4A 
computer. TEX-SEQ comes 
complete with MIDI cable in- 
terface and software. The 
package allows note-by- 
note entry of musical com- 
positions, which will play on 
any MIDI synthesizer. Soft- 
ware provides 4 play tracks 
and supports several dif- 
ferent time signatures. 
TEX-SEQ requires 32K 
memory expansion, Ex- 
World Class Software 
I 500 Valley River Dr., Suite 2SO 
Eugene, OR 97401 
(S03) 485-8796 
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User's Manuil 



tended BASIC, and a disk 
drive. Retail price is $49.95. 



♦;♦ ♦:♦ ♦:♦ 



Homework Helpers 



Bring the Teacher Home 

Spinnaker Software un- 
veiled Homework Helper 
IVlath World and Homework 
Helper Writing to teach 
students in grades 7-12 
step-by-step methods for 
math and writing home- 
work. Math World contains 
tutorial and problem-solving 

Spinnaker Software 
One Kendeil Square 
Cambridge, WI A 02 ! 39 
<6 1 7) 494- I 200 



sections, and Writing 
focuses on book reports, 
essays, and research 
papers. Both programs are 
available for the Com- 
modore 64 and 1 28 at 
$32.95 and for the IBM PC 
and Apple family computers 
at $39.95. 



♦ ♦♦♦ 



68 © Home Computer Magazine 1985 Volume 5, No. 5 



HOME CO MPUTER 



Commodore Cost Calculator 



Crunch Bills With Energy Manager 



A new program for the 

Commodore 64, designed 
to track energy use in 
homes and buildings, is now 
available from Power tine 
Software. Energy Manager 
uses utility bills as a data 
base to analyze heating and 
cooling energy usage. It 
enables month-by-month 
comparison of energy ex- 

Powerline Software 
P.O. Box 635 
New Hartford, NY 1 341 3 
(315) 735-0836 



Hands-On Screen System 



penditures for the current 
year with those of previous 
years and measures the ef- 
fect of energy conservation 
tactics. Energy Manager 
comes on diskette with in- 
teractive data-entry and 
editing programs, analysis 
programs, sample data, and 
user's manual. It's available 
for S59.95. 



Apples Get the Personal Touch 



Personal Touch ts now ship- 
ping Touch Window, a four- 
in-one touch screen input 
device for the Apple II fami- 
ly of computers. Mounted 
directly on a monitor, Touch 
Window provides any Apple 
II family computer with a 
see-through touch screen 
system. The package com- 
prises a word processor, a 
picture/graphic creator, a 
spreadsheet application, a 

Personal Touch Corp. 

4320 Stevens Creek Blvd. Suite 

San Jose, CA 95129 

C40B) 246-8822 



puzzle, and a program to 
check and recalibrate the 
touch screen. The product 
can be removed from the 
monitor for use as a 
graphics tablet, input pad, 
or interactive book pad. The 
system sells for $ T 99.95 
and comes with the Interac- 
tive Book I, a book contain- 
ing touch screen applica- 
tions and activities for ages 
three to adult. 

290 
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A First for Forth 



Apples Speak Same Language 

MIcroMotion recently re- 
leased Masterforth for the 
Apple family of computers. 
This version of the Forth 
programming language pro- 
vides a complete program- 
ming environment for the 
Apple family, comprising a 
65C02 macro-assembler 
and full interface to Apple 
DOS 3.3. As standard 

MIcroMotion 

1 2077 Wilshire Blvd. # 506 
Los Angeles, CA 90025 
(2 1 3) 82 1 -4340 



features, MasterForth 

employs a string package, 
screen editor, and resident 
debugger. Version 1 .O 
retails for S 1 25 and is also 
available for the Macintosh, 
the IBM PC and CP/M-oper- 
ating system machines. 
Users can write software 
on one system and run it on 
all the others. 



Energized Word Processing 



PaperClip is Revitalized for Atari, Commodore Computers 



Originally issued for the 
C-64, the PaperClip Profes- 
sional Word Processor by 
Batteries Included is now 
available in an updated ver- 
sion for Atari BOO and com- 
patible computers. The pro- 
gram offers Mail-Merge. 
dual-editing windows, 
graphic capability, and many 
printing functions. It sells 
for $80, PaperClip has also 
upgraded the Commodore 
version with a Spell Pack. Its 
dictionary includes over 
20,000 entries and can be 
user-expanded by 5,000 
words. PaperClip with 
SpellPack for the Com- 
modore retails for $ 1 49. 

Batteries Included 
30 Mural St. 
Richmond Hill, Ontario 
L4B 1 B5 Canada 
(416) 881-9816 
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TI Clone With A Plus 
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Tex-Comp Unveils 128K 99/4 A -Compatible, Peripherals 



Tex-Comp has announced 
its latest development, the 
TC-99/9, It's a 1 28K Tl- 
compatible computer with a 
TI processor board modified 
for a 40/SO column display. 
Tex-Comp does not plan to 
produce the TC-99/9 ex- 
cept on a special order basis. 
The firm expects to sell the 
computer for under $ 1 500. 
Tex-Comp also introduced 
its latest in enhanced peri- 
pherals for the TI-99/4A: 
the TC-1, TC-2, and TC-3. 
The TC-1 is a new expan- 
sion enclosure equipped 
with a fan-cooled regulated 
power supply, two double- 
sided, double-density drives, 
and a rear panel of 6 spike 
and surge protected ac- 
cessory outlets. It sells in- 
dividually for S4SO and, 
packaged with the Corcomp 
9900 Micro Expansion, for 

Tex-Comp 
P.O. Box 33084 
Granada Hills, CA 9 1 344 
(818) 366-6631 
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S700. The TC-2 includes 
the TC- 1 , the TI speech syn- 
thesizer, the Corcomp 
9900, and the the T1-99/4A 
console. Available by special 
order only, it sells in the 
SSOO range. Also supplied 
by special order Is the 
TC-3 — containing the same 
electronics as the TC-2, but 
with an added 1 2SK of 
memory. It sells for under 
$ 1 OOO. 




OMPUTER 

product; newsi 



Black Belts Beware 



Games Converted for Atari 

Broderbund's Champion- 
ship Lode Runner and 
Karateka are now available 
for the Atari 400, QOO, and 
XL/XE computers, in Lode 
Runner, players attempt to 
elude guards and move a 
galactic commando across 
floors to retrieve gold. 
Karateka Is a karate simula- 
tion, wherein users play the 

Broderbund Software 
1 7 Paul Dr. 

San Rafael, CA 94903 
(415)479-1 170 



role of a young karate 
master who must battle 
with an evil warlord and his 
warriors to rescue a 
princess. Karateka for Atari 
computers requires a 
joystick and 48K. Lode Run- 
ner may be played with a 
joystick or keyboard and 
also requires 48K. Both 
games are S 34.95. 



♦> ♦> ♦> ♦> 



Software Cloning 



MIDI Music Shop Developed 

Passport Designs has en- 
tered into a licensing agree- 
ment with Broderbund 
Software and developed a 
MIDI version of Broder- 
bund's The Music Shop. 
Passport reviewed many 
music-composing programs 
and chose The Music Shop 
for its editing features. The 
software allows users to 
create* store, and edit com- 

Passport Designs, Inc. 
625 Miramontes St. 
Half Moon Bay, CA 94109 
(415) 726-0280 



positions and print sheet 
music in piano or single-staff 
(treble, bass, or both) for- 
mats. It requires a one-drive 
Commodore 64, a MIDI 
keyboard, a joystick* the 
Passport MIDI Interface, 
and a dot-matrix printer. 
The MIDI version of The 
Music Shop retails for 
$99.95 and is available at 
music stores. 



♦> ♦> ♦> ♦> 



Quantum Leap for Commodore 

Telecommunications Network Introduced 



Quantum Computer Ser- 
vices has announced the 
start up of QuantumLink, a 
nationwide interactive 
telecommunications service 
for Commodore computers. 
The network offers soft- 
ware previews, electronic 
messaging and bulletin 
boards, teleshopping, news, 
a computer Information 
center, interactive telegam- 
Quantum Computer Services, Inc. 
8620 Westwood Center Dr. 
Vienna, VA221SO 
(703> 446*8700 
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ing with full-color graphics, 
on-line chat, and an elec- 
tronic encyclopedia, Quan- 
tumLink's monthly sub- 
scription fee of S9.95 in- 
cludes connection fees and 
communications charges 
for most of the offered ser- 
vices, in early 1 986, Quan- 
tumLink will be available to 
other computers. 



Modem, Modem On The Wall 



Telecommunications With The Apple II 



The Apple Personal Modem, 
now available from Apple, is 
a compact 1 200/300-baud 
modem that plugs into a 
wall socket or power strip 
and enables any Apple per- 
sonal computer system to 
communicate with main- 
frames, minicomputers, and 
other microcomputers. The 
Apple Personal Modern 
works with either tone- 
generating or pulsed tele- 
phone systems. It has dial, 
answer, and status-display 
capabilities. The Apple Per- 

Apple Computer, Inc. 
20525 Ma Hani Ave. 
Cupertino, CA 95014 
(408) 996-1010 




sonal Modem is available for 
$399. 
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The Next Generation oi Printers 



Epson Introduces FX New- Boms 



Epson America recently 
rolled out two new printers 
designed for business 
applications — the FX-85 
and FX-185, Both models 
produce draft copy at 1 69 
cps and near-letter-quality 
copy at 32 cps. They also 
offer single-stroke-selec- 
table printing modes from 
built-in IBM character sets 
and an 8K print buffer that 

Epson America 
2780 Lomita Blvd. 
Torrance, CA, 90505 
(213) 421-5426 



frees computer time while 
printing. The FX-85 is listed 
at $499, the FX-185 at 
S699. Optional cut-sheet 
feeders for automatic 
single-sheet use are avail- 
able for both models ( $ 269 
for the FX-85 feeder and 
$319 for the FX-185 
feeder). Epson also offers 
$85 upgrade kits for older 
FX-series printers. 
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It's Only Logical 



Software Designed to 'Booleanize' Students 



Sunburst Communications 
recently made High Wire 
Logic available for the Apple 
II family of computers. 
Originally part of Sunburst's 
Discrimination, Attributes 
and Rules package, the 
software introduces stu- 
dents to Boolean logic and 

Sunburst Communications, Inc. 
PleasantvIIle, NY 10570 
(914) 769-5030 



strengthens and extends 
students' capabilities in 
logical thought. The pro- 
gram is designed for 
students in grades 5-12 and 
retails for $59. It requires 
a 48K Apple Il-series 
computer. 
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Apple Note: HCM Programs RUNing on the Apple II + require 64K. 
Atari Note: All HCM programs RUN on the Atari 800, 800-XL. and 130-XE. 
Shorter HCM programs should also RUN on other Atari models with less memory. 
Commodore Note: All HCM Programs also RUN on the C- 128 in C-64 mode. 
Tandy Note: All programs for the IBM PC / PCjr commencing with the Vol. 5 No. 
5 issue are designed to RUN without modification on the Tandy 1000. 
Franklin Note: See page 9. 



DM WHAT IS A PROGRAMMER'S WINDOW? ! 



Home Computer Magazine strives to serve those eager to ex- 
pand their programming knowledge by including specific in- 
formation about the software published in these pages. This in- 
formation is contained in a separate section: the "Programmer's 
Window." For each main program included in this section there 
are 5 different pages— one for each brand of machine we cover 
(Apple II family, Atari 800-compatible family, Commodore 64, 
IBM PC & PCjr, and TI-99/4A). Each page contains 4 separate 
windows as follows: 

1) Design Focus (flow chart or diagram of a specific pro- 
cedure or program structure) 

2) Remarks (text explaining an aspect of the program 
version) 

3) Directory of Variables (definition of all variables) 

4) Listing Annotations (line-numbered program guide) 



Program Identification 

Each program header (the first few lines of 
the program) contains information giving the 
language the program is written in (e.g., TI Ex- 
tended BASIC, Applesoft, etc.) and any special 
system components that are required (memory 
expansion cards, etc.). The first two digits of 
the version number tell you in which volume 
and issue of HCM the program initially ap- 
peared. The third digit of the version number 
indicates the version of the program. When a 
program initially appears in HCM, it is version 
1. Any subsequent revisions to the program, 
if later published in the magazine or in the soft- 
ware available on magnetic media from HCM, 
will bear a revised version number. 



Volume no. 
Issue ' . 



5. 

J" 



6 . 

J 



Version —————— 

1 s original program 

2 ~ 
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no. of update 
End of Program 
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Your Guide to Typing in Programs from HCM 



Within these pages is a software bonanza: entertain- 
ment, education, home and business applications, 
utilities, and tutorials— just for you. All you need to do 
is type them into your computer. HCM has taken most 
of the strain out of this process: 

• Typeset listings with numbers in boldface. 

• A bold, double vertical bar separating the line numbers 
from the program statements in BASIC listings. 

• A vertical background grid to aid entry of the spaces. 

• An error-reducing Bug-Out Code 

Looking at the Character Reference Chart (Figure 1, 
below) will show you how each character actually ap- 
pears in the program listings^ By checking any ques- 
tionable characters with this chart, you can reduce typ- 
ing errors to a minimum. 

Figure 1: Character Reference Chart 
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Before You Begin 

Since HCM publishes for several different computers, 
the first thing you should do is make sure that you are 
looking at the listing designed for your machine. If, for 
example, you have an Apple lie, make sure you look for 
the following black bar above the listing: ■EaaEDEESai 
The computer model name will likewise appear on each 
subsequent page of each listing, so always look for the 
name before you begin typing from a new page of listings. 

Before you begin typing-in the program, you will want 
to set up a system to save your program. Whether you 
are using a cassette or diskette storage system, now is 
the time to be certain it is properly connected, powered 
up, and loaded with a blank cassette or an initialized disk. 
As you type-in your program, you should get in the habit 
of saving your work after every 20 or so lines. 

One of the most common errors in entering a listing 
is typing one symbol for another. These transpositions 
include substituting the letter O for the number 0, the 
letter 1 for the number 1, the letter S for the symbol $, 
and the uppercase B for the number 8. The last error is 
especially likely when working in hexadecimal numbers 
which are composed of the numbers 0-9 and the upper- 
case letters A-F. 

The listings in HCM are always the same number of 
characters wide, but the number of characters put on 
any line of the video display will vary from computer to 
computer. Don't try to make your listings look like the 
type-set listing—instead make sure you type the listings 
character for character and space for space. 

The Bug-Out Code (BOC) 

All HCM programs are listed with Bug-Out Codes 
(BOC— pronounced bee-oh-see) that are found in the first 
column of each program listing. The BOC is represented 
by an uppercase letter and appears before every line 
number. Take note: this character is not to be typed-in. 
One of the main reasons that we are using letters instead 
of numbers is to make sure that the BOC is not entered 
as part of a line number. 

.DON'T TYPE 
/ THIS IN 

M2|3|4|0| |G|0|S|U|B|5|8|0| | | | | | | 1 | | | | | | | | || I I I I I I I I I I 

To use BOCs for keeping bugs from creeping into your 
typed-in programs, see pages 77-79. 



A Special Note to TI Users: 

Due to architecture and language constraints with the 
TI-99/4A, users must have both Extended BASIC and 
a disk drive in order to use the BOC. We are currently 
developing a BOC program that will work with the 
Editor/Assembler Cartridge, and hope to have it soon. 

A Special Note on Atari Listings 

Atari has more special graphic characters available 
from the keyboard than any other computer that we 
cover. Reproducing these characters can often take up 
to three different key strokes. Instead of forcing our 
readers to translate each of these special characters into 
the correct key press, we include key-stroke intructions 
that are placed between two hands with pointing fingers. 
For example, when you find nr CTRL , -w in an HCM listing, 
you will know to hold down the [CTRL] key and press the 
[,] key. The result of this key press is the g symbol. 

These instructions will include a number if the operation 
is to be repeated. For example, or5 CTRL A-w tells you to 
hold down the [CTRL] key and press the [A] key 5 times. 

Whenever you see the [CTRL] or [SHIFT] keys between 
two hands, hold them down while you press the key that 
follows them. The [ESC] key is an exception. This key 
represents a separate key press. So, when you see a 
wESC CTRL +-w you are to first tap the [ESC] key, and then 
hold down [CTRL] and press the [ + ] key. 

The Atari has one special key that none of the other 
computers have. This key looks like this b and is 
used to print reverse characters. Whenever you come 
across b in a listing, simply press this key. 

When you come to the hand symbols, remember: 

• Each operation Is enclosed in its own set of hand symbols. 

• If any key action requires you to press [CTRL] or [SHIFT], press 
the control key or the shift key first and hold it down before 
pressing the second key. 

• Both the [ESC] and B keys are single key presses and should 
be pressed independently of the keys that follow them. 

• Everything between a pair of hand symbols is set in a different 
typeface. 

In Figure 2 below, we have included a chart showing 
you a representative sample of the symbols that appear 
when you use keystrokes enclosed by the hand symbols. 

Figure 2: Atari Special Symbols 
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A Special Note on C-64 Listings 

Commodore uses more than 90 special symbols to rep- 
resent various keyboard operations: for instance, the 
symbol gQ in a program represents the operation of holding 
down the [SHIFT] key and pressing the key which has CLR 
on its upper half (second key from the right on the top 
row). This operation clears the screen. 

Rather than reproducing these symbols, HCM's 
listings include key-stroke instructions, between two 
hands with pointing fingers. For example, when you 
find arSHIFT CLR-w in an HCM listing, you will know to 
hold down the [SHIFT) key and press the key witn CLR 
on it. 

A number is included if you need to repeat the opera- 
tion: or8 SHIFT CRSRLEFT-w tells you to hold the [SHIFT] key 
down and press the cursor left key (on the bottom right 
of the keyboard) 8 times. 

When you come to the hand symbols, remember: 

• Each operation is enclosed in its own set of hand symbols. 

• If any key action requires you to press two keys, press the con- 
trol key, the Commodore key, or the shift key first and hold 
it down before pressing the second key. 

• Everything between a pair of hand symbols is set in a different 
typeface. 

In Figure 3, we have included a chart showing you 
a representative sample of the symbols that appear 
when you use keystrokes enclosed by the hand sym- 



bols. (Notice that the hand symbols always appear 
within quotation marks— as in a print statement.) 



Figure 3: C-64 Special Symbols 
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Bug-Out is an error detection program for catching 
type-in mistakes. It is available for every com- 
puter brand HCM covers— Apple, Atari, Com- 
modore, IBM, and Texas Instruments. When you use 
this utility, typos are easily found and corrected. 

Before you type-in another HCM program, type-in the 
Bug-Out program specified for your computer. Because 
a properly typed-in Bug-Out routine is essential for it 
to accurately detect typing errors in other programs, 
be extra careful to ensure accuracy. Once you have it 
entered, save Bug-Out to tape (an option for Atari and 
Commodore only) or disk. 

Comparing Two Sets of BOC's 

When you look at our listings, you will notice an 
upper-case letter placed in the left-most column at the 
beginning of each program line. Separated from the line 
numbers by a bold vertical bar, this letter is the correct 
BOC. Do not type these letters in. The BOC is a quality- 
control character. Each program line is carefully 
dissected, and mathematically compacted into a single- 
character representation. 

These letters will help you detect key-in errors after 
you have a listing fully entered. When you RUN the Bug- 
Out program as directed below, it will generate smother 
series of BOCs either on the screen, or to a printer. Com- 
pare the codes generated by the Bug-Out program with 
the codes published in the left-most column of our 
listings. If a published BOC for a line is different from 
a BOC for your typed version of the same line, you will 
know that line contains a typing error. 



How To Do It 

1. The first step is to type-in the desired program. 

2. After typing the program in, SAVE it as usual. 

3. Then also SAVE the program as an ASCII text file— 
this is the format needed for Bug-Out to do its job. 
Always use a different file name to distinguish between 
the program file SAVEd in step 2 and this text file. We 
suggest you add a suffix like .T (or __T on the 99/4A) to 
the end of the text file name for added clarity. The pro- 
cess of saving programs as ASCII text files on each 
machine is detailed on page 78 (see "Turning Programs 
Into Text Files"). 

4. After you've SAVEd your program as an ASCII text 
file, make sure that the disk or tape containing the text 
file is inserted, then RUN the Bug-Out program. Once 
RUN, Bug-Out will ask for the name of the ASCII file and 
whether you want the program's output to go to the 
screen or the printer. After all this has been entered, 
the computer will print out its list of BOCs and the cor- 
responding line number. For example: 

N 100 
S 110 
Q 120 .. . 

5. Carefully go through the program listing in the 
magazine to find, and take note of, all the published 
BOCs that are different from the BOCs generated by the 
Bug-Out program. Every line that you find with a dif- 
ferent BOC code has been typed incorrectly, and should 
be carefully examined and corrected. 

To correct your mistakes (if any), LOAD (OLD on the 
99/4A) the program version (not the text file) that you 
keyed in previously. Now, make the necessary changes 
to the incorrect program lines and repeat the previous 
5 steps until all the BOC codes match. Once they all 
match, your program should be error free. 

REM statements that are not typed correctly will result 
in erroneous BOCs. If the only differences between a 
typed-in program and the magazine listing are in REM 
statements, the program will still RUN as intended. So 
you needn't waste time concerning every REM state- 
ment before running your HCM programs. Continued 
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TURNING PROGRAMS INTO TEXT FILES 



Apple II Family: The Apple method of making a program into 
a text file requires merging your typed-in program with a short 
Capture program (see below). [Note: in HCM Vol. 5, No. 5, the 
Capture program was regretably omitted.— Ed.] Our version is 
based on the Capture program found on page 1 40 of the BASIC 
Programming with ProDOS manual published by Apple. If you 
do not have either Apple Programmer's Assistant (APA) or 
Renumber program in DOS 3.3, you must type-in Capture at the 
same time as the program you are SAVEing as a text file. 

In either case, with Capture {at lines 1 through 10), and the 
program you wish to capture as a text file in memory, just type 
RUN. The Capture program then USTs the program in memory 
to disk as a text file under whatever name is INPUT when Cap- 
ture first starts running. Because HCM programs always begin 
with line 1 00, the Capture program always USTs starting at line 
1 00, and does not LIST lines 1-10, which do the actual capturing. 



Special Note to Apple Users: 

Applesoft BASIC has an idiosyncracy concerning REM 
ana DATA statements that our Bug-Out program 
takes into consideration. To ensure identical BOCs, 
always make sure your REM and DATA statements 
are typed exactly as they appear in the listing. 
Although REM statements do not affect a program s 
performance, DATA statements are often a source 
of typing bugs. Therefore, after either typing in or 
editing a DATA statement, be sure that it has the 
same number of spaces as in the magazine. 



Atari disk users enter: UST "D:PRGNAME.T" 
Atari tape users enters LIST "C:PRGNAME.T" 

C-64 disk users enter: OPEN 8,8,8,"PRGNAME.T I S I W" : CMD 

8:LIST 

When the cursor returns, enter: PRHIT # 8 : CLOSE 8 

C-64 tape users enten OPEN 1, 1,1, "PRGNAME.T": CMD 1: LIST 

When the cursor returns, enter: PRINT* 1 z CLOSE I 

IBM PC and PCjr users: SAVE the program with the ASCII op- 
tion like this: SAVE"PRGNAME.T",A 

TI-99/4A users: You can LIST your program to disk from Ex- 
tended BASIC by typing the following, with your newly typed- 
in program residing in memory: UST "DSKLPRGNAMEL-T" 
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APPLE II Family 
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DESIGN FOCUS I 



The most important routine in the TI version of 
Card-Shuffler is the Get-A-Folder routine, located in 
lines 340-480. This routine searches various folders 
and creates a record of each Card-Trix card that meets 
the search parameters' specifications. Without this 
routine, the program is useless. 

When the Get-A-Folder routine finds a card, it does 
not store the actual card in memory— it stores a 
pointer to the card. As a result, memory can hold as 
many as 4 card folders at one time. The C( , ) array 
contains the card pointers. 

We use search parameters to specify what the 
routine is to search for. The search parameters con- 
sist of the item being searched for and the fields to be 
searched through. The SE$ variable contains the item 
being searched for. The three elements of the SE( ) ar- 
ray act as flags indicating which, if any, of the three 
fields should be searched. If SE(1) equals one, the 
routine searches through the first field: the Index field. 
If SE(2) equals one, the routine searches through the 
second field, the Subject field. Similarly, SE(3) controls 
the third field, the Text field. 

The Design Focus on this page presents a flow chart 
of this routine. First, the routine OPENS the desired file 
and INPUTS the first item. The first item of a Card-Trix 
file informs us of the number of cards that are in the 
folder. The variable A stores this number. Next, we 
INPUT the first two fields of a card— the Index and Sub- 
ject fields. Using the SBC) array, the program checks 
whether it should search through these first two fields. 
If it should, the program searches through each field 
using the POS() function. When the POS() function 
returns a non-zero value, the routine sets a pointer to 
the current card. Next, the routine INPUTS the Text 
field. The program checks SE(3) to see if this field 
should be searched. The program uses the POS( ) func- 
tion to search the Text field, as well. Once again, if the 
POS( ) function returns a non-zero value, the routine 
sets a pointer to the current card. Using a FOR-NEXT 
loop, this process repeats the number of times 
specified by the variable A. 

HCM Glossary terms: array, element, field, function, parameter. 





Getting A Folder 




r 


START 


) 


* 


/ 


OPEN #1:FILENAME$ 


/ 


♦ 


/ 


INPUT #1:A 
(REM number of cards) , 


/ 


* 


1 = 1 


'F 


J 


INPUT #1:A$3$ 


/ 


L 


(REM Index, Subject) 


/ 



SET CARD POINTER 




SET CARD POINTER 



I LISTING ANNOTATIONS ! 



Line Nos. 

100-180 Program header 

190-200 Initialize program 

210 Title screen 

220-280 Main menu 

290-330 Search cards menu 

340-480 Get a folder 

490-570 Toss a folder 

580-660 Set search parameters 

670-860 Print folder index 

870-1090 Save indexed folder 

1 100-1 120 Exit program 

1 130 Erase bottom of screen 

1 140- 1 1 70 Display search parameters 

1 1 80- 1 190 Draw a box 

1200-1260 Input file name 

1270 Print "WORKING" 

1280 Error routine 

1290 Character data 



I DIRECTORY OF VARIABLES 1 



Variables Functions 

A General utility 

B General utility 

C( , ) Pointers to the cards that are found 

C$( , ) Data for one card 

FN$( ) Folders' file names 

FS$( ) Folders' search item 

I Loop counter 

J Loop counjer 

K ASCII of keyboard input 

MX Maximum number of cards 

MXF Maximum number of folders 

NF Current number of folders 

PR Flag for Printer/Screen output 

S Keyboard status 

S$ General utility 

SES Item searched for 

SE( ) Fields searched through 
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Convert Name Field 

Into "First Last" 

Format 



LISTING ANNOTATIONS ! 



line Nos. 

100-190 Program header 

200-260 Display title screen 

270-320 Initialize program 

330-350 Main loop 

360-520 General menu routine 

530-760 Editfile 

770-860 Sort tile 

870-1000 Search file 

1010-1120 Item is found 

1130-1460 I/O routines 

1 130-1 160 Ask user if load or save 

1170-1190 Input file name 

1200-1240 Input device (tape/disk) 

1250 Jump to load or save routine 

1260-1360 Load file 

1370-1460 Save file 

1470-1690 Print routines 

1700-1970 Merge routine 

1980-2090 Start the merging process 

2100-2200 Find merge code 

2210-2280 Code has been found 

2290-2340 Put name in "First Last" format 

2350-2440 Print one line of merged text 

2450-2590 Load Electronic Typewriter text 

2600-2640 Load template 

2650-2740 Update editing screen 

2750-3260 Draw editing screen 

3270-3290 Read disk error 

3300-3330 Buzz and pause 

3340-3400 Exit program 

3410-3420 Plot cursor at X,Y 

3430-3480 Menu data 

3490-3870 Machine language data for input routine 



The Electric Merge in the Commodore 64 version 
of Electronic Postman has a very useful feature: It 
enables you to specify a person's first or last name. 
If you use a merge code of *F, for example, you are 
instructing the computer to replace the code with 
the first name only. Conversely, *L specifies the last 
name. 

Electronic Postman uses a short subroutine 
located in lines 2290-2340 to separate the first and 
last name of a Name field entry. Note that there are 
two different formats in which you can enter a 
name: You can enter a name as "Last, First" oi 1 
"First Last." Take the name John Smith, for exam- 
ple. With Electronic Postman you have the option 
of entering this name as "Smith, John" or, as one 
might normally write it, "John Smith." 

The Design Focus on this page provides a flow 
chart of the name-separating subroutine. First, this 
subroutine sets the variable CS equal to the Name 
field of the current record and initializes D, our loop 
counter, to equal one. Using D as an index, Elec- 
tronic Postman searches for the first space in C$. 
If it finds a space, the program checks to see if a 
comma precedes that space. If so, the program 
eliminates the comma from C$ and switches the 
first and last names. If it does not find a comma, 
the subroutine ends because CS is already in "First 
Last" format. When the subroutine ends, C$ is in 
"First Last" format with the variable D equal tq the 
location of the separating space. 

HCM Glossary terms: field, subroutine. 



DIRECTORY OF VARIABLES ! 



Variables 

A 

BLS 

C$ 

CD 

CD$ 

D 

E 

E$ 

EX 



I 

J 

K 

K$ 

L 

LM 

LN 

M 

M$<) 

MC 

MD 

ME<) 

MX 

N 

NS(.) 

RM 

S 

SS 

SC$ 

SP 

T$ 

TP$<) 

TX$() 

X 

Y 

Z 



Functions 

Utility variable 

80 blank characters 

Used in merge routine 

Number of merge code (1-8) 

String containing merge codes 

Utility variable 

Disk error number 

Disk error descriptor 

Exit flag 

Electronic Typewriter (ET) file name 

Loop counter 

Loop counter 

ASCII of keyboard input 

Keyboard input character 

Utility variable 

Left margin 

Current line of ET text 

Current menu 

Menu options 

Menu option chosen by user 

Current field in edit screen 

Menu data array 

Maximum number of records 

Current record number 

Record data 

Right margin 

Utility variable 

Utility string 

Password for merge 

Spacing 

Program title 

Template array 

Text array 

Screen column 

Screen rdvr 

Utility variable 
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DATA Statements Used In Formatting The Edit Screen 



COLUMN . 



R 
O 
W 



3 
5 

7 

9 

11 

13 

15 



2 




20 

1 






NAME: 
' ADDR: 
CITY: 
, STATE 
PHONE 
TEXT: 
CODE:_ 






















ZIP: 






NUM: 














REC. 


NOM: 





EDIT SCREEN 



3060 DATA "NAME:* 

-STATE ZIP:-, 9, 2, 25, "PHONE Nt 
2, 30, "CODE:", 15, 2, 4, "REC. NUM:* 




FIELD NAME 
ROW POSITION 
COLUMN POSITION 
LENGTH OF INPUT FIELD 



2, 30, "CITY:", 7, 2, 30, 
, 11, 2, 25, "TEXT", 13, 
15, 20, 2 



1 LISTING ANNOTATIONS 1 



line Nos. 

100-190 Program header 

200-280 Program main line 

290-330 Main menu 

340-450 Edit file 

460-640 Sort file 

650-770 Search file 

780-850 Item is found 

860-920 Ask user if load or save 

930-1020 Load me 

1030-1080 Save file 

1090-1240 Print file 

1250-1460 Electric merge 

1470-1590 Merging and printing 

1600-1710 Find "** code 

1720-1800 Merge code has been found 

1810-1860 Put name in "First Last" format 

1870-2000 Print one line of Electronic Typewriter text 

2010-2080 Exit program 

2090-2130 Edit screen 

2140-2260 Edit an item on edit screen 

2270-2290 Enter a number 

2300-2410 Enter a line with cursor control 

2420-2670 Enter file name 

2680-2690 Turn on printer 

2700-2710 Turn off printer 

2720-2760 Configure menu 

2770-2850 Operate menu 

2860-2920 Ring bell twice and pause 

2930-3070 Program initialization 

3050 Keypress data 

3060 Editing screen data 

3080-3270 Error handler 

3080-3110 Read error and branch accordingly 

3120-3270 Print error 



The Apple version of Electronic Postman uses a 
very structured method to format the program's 
edit screen. The DATA statement in line 3060 con- 
tains all the formatting information that the pro- 
gram needs to arrange the edit screen's 8 fields. 
This data is in the following format: 3060 field 
name, screen row position, screen column position, 
length of field ... 

We use this data to get the different field names 
and place them on the screen at the indicated row 
and column position. When receiving input for one 
of these fields, the program uses the length of field 
data to determine the maximum number of 
characters that can be entered. See the Design 
Focus for an illustration of how line 3060 controls 
the edit screen's format. 

HCM Glossary terms: field. 



□ 



DIRECTORY OF VARIABLES! 



Variables Functions 

A.B.D.N.X.Y General purpose 

B80$ String of 80 spaces 

BK$ One space 

BL$ CHR$(7), bell sound 

BX$ CHR$(2), control B 

C Electronic Typewriter (ET) line code 

C$,S$,X$ General purpose 

CD Merge code value 

CD$ String of merge codes 

CRS CHR$(13), carriage return 

D$ CHR$(4), wakes up DOS 

DIJT, JI.KI.SI Loop counters 

DN$ CHR$(10), cursor down 

DR$ Number of disk drives 

DX$ DELETE command character 

E Error code 

ECS( , ) Edit command codes and field names 

EC( , ) Edit page field locations and lengths 

EN$( ) Keyboard entry anay 

EOL Address of "clear to the EOL" routine 

ESC$ CHR$(27), ESC character 

FL$,FT$ File names 

FL$( ) Keyboard entry anay for me name 

GC Used in "get char" routine 

HB.HC Horizontal screen locations 

HX Pointer during keyboard entry 

IN$ Single character entry 

LXS Insert command character 

JP Field selector on edit screen 

LF Length of field in file-name entry 

LF$ CHR$(8), cursor left 

LM.RM Left and right margins in ET me 

LN Line pointer in ET file printout 

LS Length of field on edit screen 

MC( ),MN$( ) General menu routine parameters 

MD Number of current field being edited 

MN( , ) Screen locations for menu items 

MX Maximum number of records 

N$(.) Records 

N1.N2.N3.N4 Number entry parameters 

P1.P2 First and last record to print 

RS Controls returns from error routine 

RT$ CHR$(21), cursor right 

S Save number of current record 

S$( ) Temporary storage for sort routine 

SC$ Electronic merge code 

SP Spacing for ET me 

SV Template flag when loading an ET me 

SX$ Null string 

TM Maximum number of lines in ET me 

TP$( ) Line codes in ET file 

TX$() Text line in ET me 

UP$ CHR$(11), cursor up 

VC.VF Vertical screen locations 
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Finding The Merge Codes 
During an Electronic Merge 



YES 



A$ 

CD : 



AaA + 1 
= MID$(S$,A,1) 
INSTR(CD$,A$) 



CODE IS NOT FOUND 




CODE IS FOUND! 



END 



D 



! LISTING ANNOTATIONS ! 



LineNos. 

100-210 Program header 

220-280 Display title screen 

290-360 Initialize program 

370-390 Main loop 

400-560 General purpose menu routine 

570-770 Edit file 

780-980 Search file 

990-1180 I/O routines 

1190-1390 Print file 

1400-1490 Sort file 

1500-1570 Exit program 

1580-1690 Display edit screen 

1700-1740 Update editing screen 

1750-1870 Display various kinds of boxes 

1880-2050 Main section of input routine 

2060-2150 Place character on screen and in string 

2160-2180 Cursor right 

2190-2210 Cursor left 

2220-2240 Toggle insert mode 

2250-2270 Backspace 

2280-2300 Delete a character 

2310-2340 Buzz and pause 

2350-2370 Trap file error 

2380-2420 Display file error 

2430-2480 Get file name 

2490-2660 Load text file 

2670-2840 Merge routine 

2850-2960 Start merging and printing 

2970-3040 Find"*" code 

3050-3120 Code has been found-^merge code 

3130-3180 Put name in "First Last" format 

3190-3290 Print one line of Electronic Typewriter text 

3300-3360 Menu data 



The IBM computer's INSTR function can be very 
useful, especially in a program like Electronic 
Postman. During an Electric Merge, the computer 
must search through an entire text file for merge 
codes. The INSTR makes this task much easier. The 
Design Focus on this page provides a flow chart of 
the routine that searches for merge codes (lines 
2970-3040). 

The Electric Merge must look for 8 different 
codes— represented by the letters N, A, C, S, P, T, 
F, and L. To shorten the program, we set the 
variable CD$ equal to "NACSPTFL". Using the INSTR 
function, the program searches through a line of 
text from left to right, looking for asterisks. For each 
asterisk that the program finds, we assign A$ equal 
to the character directly following the asterisk. Us- 
ing the INSTR function again, we determine whether 
A$ is a proper merge code. The computer accom- 
plishes this with the following code: 
CD = INSTR<CD$,A$) 

If CD equals zero, A$ is not a proper code. Other- 
wise, CD indicates which code has been found. 

HCM Glossary terms: function. 



! DIRECTORY OF VARIABLES ! 



Variables 

A 

B 

BL$ 

CD 

CD$ 

CS 

D 

Dl 

EX 

F$ 

FCS 

LCS 

INS 

K$ 

L(.) 

LM 



RM 

LN 

M 

M$<) 

MC 

MD 

ME<) 

MX 

N 

N$(, 

P$ 

PX 



PY 

QT 

S$ 

SC$ 

SP 

SPACES 

T$ 

TF$ 

TP$() 

TX$ 

UL, UR, LL 

LR, HI, H2 

VI, V2 

X, Y, W, H 

Z 



Functions 

Counter to string position when search- 
ing for "*" code 
Used in search routine 
String of blank characters 
Number of merge code (1-8) 
String containing merge codes 
Number of characters in input 
Utility variable 
Utility variable 
Exit flag 
File name 

First character accepted by input 
Last character accepted by input 
Insert flag for input routine 
String used to input from keyboard 
Array with edit screen data 
Left margin for Electronic Typevniter 
<ET) text 

Right margin for ET text 
Current line in ET text 
Current menu option 
String array with menu options 
Menu option chosen by user 
Current field in editing field 
Array with menu data 
Maximum number of records 
Current record number 
Record data 

Prompt string for file routine 
Horizontal position for "Get File Name" 
function 

Vertical position for "Get File Name" 
function 

Flag used to remove quotation marks 
String returned in input routine 
Password for Electric Merge 
String position for input routine 
Line spacing for ET text file 
Program title 

Previously entered file name 
ET template array 
ET text array 
Various parts of a box 
Various parts of a box 
Various parts of a box 
Parameters for box drawing 
Utility variable 



A 

if! 

<\ 

U 

® 

fid 
M 
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START 



SC$ = PASSWORD 

S$ = CODE FIELD OF RECORD 

,D«=0 Ial 



Doing A Selective Merge 



S$(I,I) 



sc$a, 



SC$(I,I) 



AND 


***^JJTES 






7 ^*^^ 




<f 


*"T* 


D = l 






I LISTING ANNOTATIONS j 



Line Nos. 

100-190 Program header 

200 Set up program 

210-250 Display title screen 

260-350 Initialize program 

360-390 Main loop 

400-460 Menu handler 

470-560 Edit file 

570-730 Bubble sort 

740-850 Search routine 

860-890 Item is found 

900-910 Item is not found 

920-930 Call machine language search routines 

940-1020 Get file name 

1030-1150 Disk I/O 

1160-1180 Cassette I/O 

1190-1270 Load file 

1280-1360 Save file 

1370-1490 Load Electronic Typewriter (ET) text 

1500-1640 Print file 

1650-1740 Process formatting code for ET text 

1750-1770 Handle ET "B" line code 

1780-1820 Handle ET "C" line code 

1830-1870 Handle ET ' 'D' ' line code 

1880-1930 Handle ET "E" line code 

1940-2010 Print routines for ET text 

2020-2040 Set up merge 

2050-2170 Process merge 

2180-2270 Do selective merge 

2280-2410 Find the "*" code 

2420-2530 Found code— merge it 

2540-2620 Put name in * 'First Last' ' format 

2630-2650 Print a merged line 

2660-2670 Update string index 

2680-2750 Update edit screen 

2760-2870 Draw edit screen 

2880-2910 Exit program 

2920-3160 Input routine 

3170-3300 CIO routine— I/O handler 



The Electric Merge in the Atari version of Elec- 
tronic Postman contains a useful Selective Merge 
option. With this option, you can selectively specify 
which of your records will merge with your Elec- 
tronic Typewriter text file. The routine located in 
lines 2180-2220 contains the heart of the Selective 
Merge option. This routine takes the current Code 
field of a record and compares it with the password. 
If there is a match, the program merges the record. 
If not, the program goes on to the next record. 

When comparing the Code field with the 
password, the program takes wild cards (question 
marks) into account. If a password contains a ques- 
tion mark, the program ignores the corresponding 
Code field character. The program uses the variable 
D to flag discrepancies between the Code field and 
the password. 

HCM Glossary terms: field, record. 
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Variables Functions 

A General purpose 

ADD Used in CIO routine 

ADH Used in CIO routine 

ADL Used in CIO routine 

BL$ Eighty blank characters 

C$ Used in merge routine 

CD Number of merge code (1-8) 

CFLAG Flag lor cassette I/O 

CHN Used in CIO routine 

D General purpose 

F$ Electronic Typewriter (ET) text file name 

FIDX Field index 

FIND$ Used in search routine 

FLEN Field length 

FOFF( ) Array of field offsets 

I, J, W Loop counters 

INDENT Indent value for ET line codes 

INDENTS String representation of indent codes 

IOCB Used in CIO routine 

IOFLAG Used in I/O routine 

K ASCII of keyboard input 

L General purpose 

LM Left margin 

LN Current line of ET text 

LSPACE Line spacing for ET text 

MAXLEN Maximum line length of ET text 

MC Menu option chosen by user 

MD Current field in edit screen 

ML$ Machine language for flipping be- 
tween inverse and normal text 

ML2S Machine language used in input 
routine 

N Current record number 

N$ Record data 

NMH Used in CIO routine 

NML Used in CIO rouitne 

NUM Used in CIO routine 

P Used in formatting ET text 

RIDX Record index 

RM Right margin 

RWF Used in CIO routine 

S General purpose 

S$ General purpose 

Sl$ Used in sort 

S2$ Used in sort 

TFLAG Load template? 

TPS ET template string 

TX$ ET text string 

Z General purpose 
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Efficient allocation of the workforce is critical to the 
success of a Serf City kingdom, as it is to any 
economy. The TI version of Serf City has a built-in 
algorithm that allocates workers to various occupa- 
tions according to a specific hierarchy. The Design 
Focus illustrates the structure of this algorithm. 

First the program automatically deducts soldiers 
from the workforce. It then tries to fill the fields with 
sufficient workers to harvest the wheat. To determine 
the number of people to allocate to field work, the pro- 
gram takes the number of bushels of wheat to be 
planted, then places one person in the fields for each 
bushel— if the population is sufficient. If the popula- 
tion is not large enough to plant all the seed, the pro- 
gram places all of the available workers in the fields, 
however, it reduces the number of bushels planted to 
equal the number of workers. 

After the program pulls field workers and soldiers 
from the population, it staffs the mills. The amount 
of people that the program can allocate to the mills 
depends on the remaining population, the number of 
mills, and the commerce tax rate. A high commerce 
tax rate restricts the number of people that the pro- 
gram can employ in each mill. 

After fully staffing the mills, the program employs 
any remaining population in commerce. The program 
determines the amount of people that can be 
employed in commerce according the the remaining 
population, the number of units of commerce, and the 
commerce tax rate. 

If the kingdom has additional population after the 
fields, mills, and commerce are fully staffed (in that 
order), the program considers this remainder 
unemployed. 



Serf City Employment 




REDUCE SEED PLANTED 
FOR AVAILABLE LAND 



REDUCE FIELD WORKERS 
TO AVAILABLE POPULATION 



CALCULATE MILL WORKERS 

NEEDED BASED ON NUMBER 

OF MILLS AND 

COMMERCE TAX RATE 




REDUCE SEED PLANTED TO 
NUMBER OF FIELD WORKERS 



REDUCE MILL WORKERS TO 
THE AVAILABLE POPULATION 



CALCULATE NUMBER OF 

COMMERCE WORKERS NEEDED 

BASED ON UNITS OF COMMERCE 

AND THE COMMERCE TAX 




j REDUCE COMMERCE WORKERS 
-*| TO AVAILABLE POPULATION 



DISPLAY LEVELS OF 
EMPLOYMENT FOR THE YEAR 



in 
® 

§1 



LISTING ANNOTATIONS 



DIRECTORY OF VARIABLES ! 



Line Nos. 

100-190 Program header. 

200-340 Title screen and initialization 

350-390 Players' names 

400-510 Main control loop 

520-620 Main data screen 

630-820 Map screen 

830-980 Move cursor 

990-1250 Add unit of land to map 

1260-1460 Resolve conflict 

1470-1570 Add mill 

1580-1680 Add unit of commerce to map 

1690-1770 Update string array S$( ) 

1780-1850 wheat option menu 

1860-1930 Feed people 

1940-2010 Plant seed 

2020-2090 Store wheat 

2100-2170 Buy wheat 

2180-2250 Sell wheat 

2260-2380 Input routine 

2390-2440 Bad input messages 

2450-2730 Hire/fire soldiers 

2740-2970 Set tax rate routine 

2980-3760 Year-end report routine 

3770-3910 End-of-game routine 

3920-4020 Print main data screen 

4030-4080 Print map screen 

4090-4270 Initialize program variables 

4280-4290 Map screen format data 

4300-4310 Character definition data 

4320-4340 Time delay routine 

4350-4370 Key scan routine 



Variables Functions 

P$( ) Players' names 

S$( ) Map screen 

K( , ) Kingdom information 

A$ Input routine utility 

B$ Input routine utility variable 

11$, 12$ Legal keys list 

A Value returned from input routine 

A0, Al, A2, 

A3 Constants for 0, 1, 2, and 3 

A4, A5, A6, 

A7 Constants for 4, 5, 6, and 7 

A8, A9 Constants for 8 and 9 

C Character under cursor 

CI Character above cursor 

C2 Character below cursor 

C3 Character left of cursor 

C4 Character right of cursor 

CH Character placed into map 

DN End-of-game flag 

E Employment in fields 

F Employment in mills 

G Employment in commerce 

P Prosperity of people 

PI Current player 

P2 Opposing player 

R Random number 

S Status from scanning keyboard 

VW Value of wheat during year 

W Key returned from key scan 

X Screen coordinates 

Y Screen coordinates 

YR Current year of simulation 

Z Utility loop counter 



© Home Computer Magazine 1985 Volume 5, No. 6 



81 



PROGRAMMER'S WINDOW 



I REMARKS! 



In the Commodore version of Serf City, prosperity 
plays a major role in population control and tax in- 
come. For the purposes of this program, prosperity is 
a calculation based on the wheat available per person, 
the ratio of mill workers to population, and the per- 
sonal tax rate. 

The calculated value for prosperity is stored in the 
variable P. P = wheat for food / (population * 5) * (mill 
workers + 1) / (population * .1) * ABS ((110 - personal tax 
rate) * .01). 

Because each person requires 5 bushels to survive, 
the program first multiplies. 5 by the number of peo- 
ple, then divides the total amount of wheat allocated 
to food by this value. This results in the amount of 
wheat available per person. The next factor that con- 
tributes to prosperity is the ratio of mill workers to the 
population. Prosperity is further affected by the per- 
sonal tax rate. The expression (110 - personal tax rate) 
* .01 means prosperity decreases with a higher tax 
rate. 

If P is less than 1, the population decreases due to 
emigration, a lower birth rate, and a higher death rate. 
If P reaches a zero, the entire population dies, and the 
player loses. If, on the other hand, P is greater than 
1, population increases due to immigration, a higher 
birth rate, and a lower death rate. If P = 1, status quo 
is maintained. 

If the food supply exceeds 5 bushels of wheat per 
person, the prosperity value increases. If the food 
supply drops below this limit, prosperity decreases. 
The ratio of mill workers to the population affects pros- 
perity in a similar manner: If less than 10% of the 
population is working in the mills, prosperity drops 
below. 1. If the personal tax rate is above 10%, pros- 
perity decreases. If the rate is below 10% prosperity 
increases. 



! LISTING ANNOTATIONS \ 



Line Nos. 

100-190 Program header 

200-260 Title screen 

270-310 Initialize program 

320-370 Get players' names 

380-420 Main control loop 

430-510 Main data screen 

520-620 Display map screen, get key press 

630^740 Cursor movement routines 

750-1040 Add unit of land 

1050-1 130 Add mill or commerce 

1 140-1220 Wheat option main menu 

1230-1260 Feed people 

1270-1300 Plant seed 

1310-1340 Put wheat in storage 

1350-1380 Buy wheat 

1390-1420 Sell wheat 

1430-1500 Input routine 

1510-1520 Bad input messages 

1530-1680 Hire/fire soldiers routine 

1690-1820 Set tax rate routine 

1830-2360 Year-end harvest report 

2370-2490 End-of-game routine 

2500-2650 Display main data screen 

2660-2930 Initialize program 

2940-3040 Load old game 

3050-3140 Save game 

3150-3170 Check disk error channel 

3180-3220 Play-again option 

3230-3260 Routine to shift and display text 



DESIGN FOCUS 



Serf City Prosperity 



WHEAT AVAILABLE 
FOR FOOD 



110 - (PERSONAL TAX 
RATE) * .01 



NUMBER OF MILL 
WORKERS + 1 




POPULATION • 5 



*) fcj OVERALL PROSPERITY 
J W M OF THF PEOPMC 



POPULATION 



! DIRECTORY OF VARIABLES I 



Variables Functions 

K< , ) Kingdoms" vital statistics array 

P$( ) Players' names 

A$, B$ Get inputs 

DN$ Value of DN for file routine 

F$ File name 

11$, 12$ Legal characters 

K$ Numeric file access 

S$ Text to be displayed 

VW$ Value of VW for file routine 

W$ Key pressed 

YR$ Value of YR for file routine 

A Value of input utility 

A0, Al, A2, A3 Constants for 0, 1, 2, and 3 

A4, A5, A6, A7 Constants for 4, 5, 6, and 7 

A8, A9 Constants for 8 and 9 

C Character under cursor 

CI, C2, C3, C4 Characters around cursor 

CH Character placed into map 

DN End-of-game flag 

E Employment in fields 

F Employment in mills 

G Employment in commerce 

L Length of string 

P Prosperity of people 

PI Current player 

P2 Opposing player 

R Random number 

S ,SID chip start address 

V Start of video memory 

VW Value of wheat 

W ASCII value of key pressed 

X, Y Screen coordinates 

YR Current year 

Z Utility loop counter 
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PROGRAMMER'S WINDOW 



! REMARKS! 



The Design Focus for the Apple version of Serf City 
shows how the program continually updates and 
displays each kingdom's population. Either kingdom's 
population can increase or decrease due to births, 
deaths, immigration, and emigration. The amount of 
wheat available per person, personal tax rate, and the 
ratio of mill workforce to total population are some of 
the other factors that alter population. The variable 
P (prosperity) contains all of these factors. 

We use this formula to calculate the number of 
births: BIRTHS = INT(K(Z,8) * .05 *P * RND(1». Here, K(Z,8) 
represents the current population. Births cannot con- 
tribute more than 50% of a year's population growth. 
The next step in calculating population is to determine 
the number of deaths: DEATHS = INT(K(Z,8) * .2 / P * 
RND(l)). (The numbers .05 and .2 in these equations 
are scaling factors.) If deaths exceed current popula- 
tion, the end result will be zero, and the kingdom will 
die. 

Finally if P is greater than or equal to 1 ("even" or 
good prosperity), the program calculates the number 
of people that moved into the kingdom during the 
year. But if P is less than l(poor prosperity), the pro- 
gram calculates how many people moved away from 
the kingdom: 1) MOVE TO = INT(RND(1) * K(Z,7) * .2 - 
(KZ.8)). 2) MOVE AWAY = INT((K(Z,8) * P * RND(1» - K(Z,8» 
Here, K(Z,7) represents the amount of food available. 
Adding immigrants to, or subtracting emigrants from, 
the previous calculations yields the Updated figure. 



! LISTING ANNOTATIONS ! 



Line Nos. 

100-200 Program header 

210-280 Title screen 

290-310 Reload above high-resolution screen 

320-380 Initialize program 

390-400 Get option to include sound effects 

410-430 Get option to load previous game 

440-490 Get players' names 

500-620 Main data screen and options 

630-800 Map screen, get options 

810-920 Add unit of land to map 

930-1030 Resolve conflict 

1040-1070 Add mill to map 

1080-1 1 10 Add commerce to map 

1 1 20- 1 150 Put character on screen 

1160-1240 Wheat menu 

1 250- 1 270 Feed people 

1280-1300 Plant seed 

1310-1330 Store wheat 

1340-1360 Buy wheat 

1370-1390 Sell wheat 

1400-1420 Input routine 

1430-1450 Bad input messages 

1460-1610 Hire/fire soldiers 

1620-1730 Set tax routine 

1740-2150 Year-end harvest routine 

2160-2270 Display the main data screen 

2280 Sound routine 

2290-2300 Key scan routine 

2310-2350 Option to save game 

2360-2380 Option to continue game 

2390-2490 Exit game, show results 

2500-2590 Load old game 

2600-2670 Save game to disk 

2680-2780 Error routine 

2790 Data for initial kingdom 

2800-^2820 Initial data for map screen 

2830-2890 Misc. program data 



! DESIGN FOCUS ! 



Serf City Population Growth 
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DIRECTORY OF VARIABLES ! 



Variables Functions 

P$( ) Players' names 

S$( ) Map screen 

K( , ) Kingdom information 

A$, B$ Input routine 

A Value returned from input routine 

C Character under cursor 

CI, C2, C3, C4 Characters around cursor 

DN End-of-flag routine 

E, F, G Employment levels 

OFF Turns off graphics routine 

P Prosperity of people 

PI Current player 

P2 Opposing player 

PD Prodos flag 

PRNT Graphics print routine address 

R Random number 

SOUND Sound-effects routine address 

VW Value of wheat during year 

X, Y Screen coordinates 

YR Current year of simulation 

Z Utility loop counter 
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PROGRAMMER'S WI NDOW 



! REMARKS! 



Serf City wouldn't be realistic without enabling the 
kingdoms' armies to battle for land ownership. The 
IBM routine outlined in the Design Focus depicts the 
process of combat resolution— how the program 
decides which army wins. 

To determine if combat is possible, the^program first 
uses the SCREEN function to get the colors of the 
characters next to the cursor and stores them in the 
variables CI, C2, C3, and C4. In this way, it determines 
whether the cursor is next to the player's own land. 
If so, a routine checks the color of the character 
beneath the cursor. If it is the opposing player's col- 
or, the program branches to a routine to resolve the 
conflict. 

The number of soldiers, the amount of land, and the 
pay per soldier form a measure of each player's 
strength going into the battle. The program uses the 
following equation to determine the battle outcome: 

P = K(P1,9) * K(P1,10) / K(P1,1) - K(P2,9) * K(P2,10) / K(P2,1) 

ATTACKER DEFENDER DATA TYPE 

K(P1,1) K(P2,1) Total land owned 

K(P1,9) K(P2,9) Number of soldiers 

K(P1,10) K(P2,10) Soldier's pay 

For each player, the kingdom's total number of 
soldiers is multiplied by the pay per soldier and then 
divided by the kingdom's total land. The resulting 
4 ^strength" of the defender is subtracted from the 
strength of the attacker to set the value of P. If P is 
equal to a number greater than zero, the attacker 
wins. If P is less than zero, the defender wins. If the 
value of P is zero, a tie is indicated. In this case, the 
program determines the winner randomly. 



LISTING ANNOTATIONS 1 



Line Nos. 

100-240 Program header 

250-310 Initialize program 

320-360 Load saved game 

370-440 Get players' names 

460 Set up playing screens 

460 Main control loop 

470-540 Main data screen options 

550-690 Start Map option 

700-850 Add land 

860-900 Add mill 

910-950 Add commerce 

960-1020 Resolve conflict 

1030-1 130 Display main data screen 

1 140-1260 Initialize map screen 

1270-1430 End-of-game routine 

1440-1550 Build wheat option screen 

1560-1760 Wheat options routine 

1770-1810 Bad input message 

1820-1920 Build soldiers screen 

1930-2070 Soldiers option routine 

2080-2200 Build tax screen 

2210-2310 Tax option routine 

2320-2810 Year-end harvest routine 

2820-2870 Display bold box 

2880-2920 Display box 

2930-3120 Input routine 

3130 Initialization data 

3140-3160 Main data screen data 

3170 Get file name 

3 1 80-3230 Error trapping routine 



! DESIGN FOCUS 



Serf City Combat Resolution 




DIRECTORY OF VARIABLES | 



Variables Functions 

K( , ) Player information array 

P$( ) Players' names 

S$( > Main data screen array 

A$ Format string for PRINT USING 

BS 40 spaces 

E$ Error message text 

FH$ File name 

1$ Test for key press in error routine 

K$ Return key pressed in input routine 

MS$ Invalid input message 

S$ String returned from input routine 

TST$ Illegal-file-name characters 

Al Returns character from screen 

A2 Returns color of screen location 

C Player color 

CI, C2, C3, C4 Characters around cursor 

CS Input string length 

D Utility 

DD Delay counter 

DN Game over flag 

E Employment in fields 

EL Line where error occurred 

ER Enor code 

F Employment in mills 

G Employment in commerce 

H, W Height and width of box 

HI, H2, VI, V2 Box-edge characters 

I Utility 

L Length of string to get 

LL Lower-left corner of box 

LR Lower-right corner of box 

P Utility 

PI Current player 

P2 Opposing player 

R Random number 

SP Position in input routine 

ST Enor return flag 

T Temporary variable 

UL Upper-left corner of box 

UR Upper-right comer of box 

VW Value of wheat 

X, Y Screen coordinates 

YR Current year of game 

Z Loop counter for year-end harvest 



84 © Home Computer Magazine 1985 Volume 5, No. 6 



PROGRAMMER'S WINDOW 



Serf City 



REMARKS! 



! DESIGN FOCUS ! 



In the Atari version of this simulation, there are two 
types of tax— a personal tax placed on a kingdom's 
population, and a commerce tax placed on a 
kingdom's mills and commerce. The program uses a 
"prosperity variable" as a measure of the kingdom's 
wheat available per person, the personal tax rate, and 
the ratio of mill workforce to total population. The ad- 
jacent Design Focus depicts how prosperity and other 
variables combine to determine both the kingdom's 
personal tax income and its commerce tax income. 

The personal tax affects all employed citizens in the 
kingdom. To calculate the personal tax, we first add 
the number of people working in fields, mills, and 
commerce. 

TOTAL EMPLOYED = FIELDS + MILLS + COMMERCE 

We then multiply this value by the prosperity vari- 
able, by the personal tax rate, and by a scaling factor. 

PERSONAL TAX INCOME = EMPLOYED * TAX RATE * PROSPERITY * . 15 

The number of people employed in mills and com- 
merce determines the commerce tax income. These 
two workforces combine into a total, which the pro- 
gram uses as one variable to determine the kingdom's 
commerce tax income. As with the personal tax, the 
prosperity variable also figures in the commerce tax 
equation. The following expression shows how we 
multiply the number of workers in the mills and com- 
merce by the prosperity variable, commerce tax rate, 
and a scaling factor to arrive at the commerce tax 
income: 

COMMERCE TAX INCOME = EMPLOYED # TAX RATE * PROSPERITY * .25. 



Serf City Tax Structure 
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i LISTING ANNOTATIONS ! 



! DIRECTORY OF VARIABLES j 



Line Nos. 

100-190 Program header 

200-270 Initialize program 

280-290 Title screen 

300-320 Get option to load old game 

330-380 Get players' names 

390-410 Main control loop 

420-490 Main data screen and options 

500-660 Map screen and options 

670-810 Add unif of land to map 

820-860 Add commerce to map 

870-910 Add mill to map 

920-1020 Resolve conflict 

1030-1 1 10 Wheat option screen 

1 120-1 140 Feed people 

1150-1170 Plant seed 

1180-1200 Store wheat 

1210-1230 Buy wheat 

1240-1260 Sell wheat 

1 270- 1 320 Input routine 

1330-1340 Bad input messages 

1350-1520 Hire/fire soldiers 

1530-1580 Set tax rate routine 

1590-1980 Year-end harvest report 

1990-2110 End-of-game routine 

2120-2270 Load and save routine 

2280-2380 Display main data screen 

2390-2460 Program data 

2470-2600 Initialization routine 

2610-2680 CIO routine for disk and tape operations 



Variables 

K(.) 

Pl$, P2$ 

K$ 

AS, B$ 

ML$ 

S$ 

A 

ADD, ADH, ADL 

CHN, DL, IOCB 

NMH, NMLNUM 

C 

CI 

C2 

C3 

CH 

DN 

£ 

F 

G 

P 

PI 

P2 

R 

RWF 

VW 

W 

YR 

Z 



Functions 

Kingdom's vital statistics, array 

Players' names 

Legal keys 

Input routine utility variable 

Machine language routine 

Map screen 

Value returned from input routine 

For CIO routine 

For CIO routine 

For CIO routine 

Character under cursor 

Utility for calculations 

Utility for calculations 

Utility for calculations 

Character placed into map 

End-of-game flag 

Employment in fields 

Employment in mills 

Employment in commerce 

Prosperity of people 

Current player 

Opposing player 

Random number 

For CIO routine 

Value of wheat during year 

Key returned from key scan 

Current year of simulation 

Utility loop counter 
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PROGRAMMER'S WINDOW 



Cell Mates 



REMARKS! 



! DESIGN FOCUS ! 



One of the most complex algorithms in the TI ver- 
sion of Cell Mates is the one that determines the level 
of protein. Protein can either be produced by the 
ribosomes, or it can be imported from outside the cell. 
At the start of the simulation, the protein level is at 
50% of maximum. The protein supply must reach this 
maximum for the cell to reproduce. It is not easy to 
double the supply of protein, however, because pro- 
tein must be exported. The Design Focus illustrates 
the algorithm that we use to control these processes. 

Ribosomes are the primary source of protein. Each 
ribosome can produce a limited amount of protein, 
however, so the number of ribosomes present deter- 
mines the amount of protein that can be produced in 
any given period. This control factor is represented in 
the Ribosome Level parameter in the flow chart. The 
routine multiplies the number of ribosomes by the 
Protein Energy (the amount of ATP available for pro- 
tein production) and calculates the square root of the 
result to arrive at the optimum protein production 
value. The routine then takes other controlling factors 
into consideration. These factors include the cell's age, 
the internal temperature deviation from optimum, 
and the amount of available nutrients—all of which 
have a detrimental effect on the cell's ability to pro- 
duce protein. The routine multiplies the optimum in- 
crease in protein production by adjustments based on 
these three factors to determine the increase in pro- 
tein level. 

The routine then adds the present protein import 
and executes a check on the result for the maximum 
and minimum protein increases in order to avoid 
unrealistic results. 

The value we end up with after all of this calculating 
is the amount of change that is to take place in the 
target protein level, or the level that protein would 
reach if change in level were instantaneous. The 
routine adds this value to the present target protein 
level to determine the new target protein level. 

Three equations contain the entire algorithm and 
are located in lines 440, 470, and 480. 

HCM Glossary terms: ATP, ribosomes 



! LISTING ANNOTATIONS I 



Line Nos. 

100-190 Program header 

200-240 Program initialization 

250-280 Main control loop 

290 Branch to end-of-program routine 

300-320 Option to exit game 

330-480 Vital statistics calculations 

490-530 Check vital status 

540-670 Cell dies from various causes 

680-710 Cell reproduces 

720-730 Option to play again 

740-770 Update meter positions 

780-790 Update mitochondrion motion 

800-850 Administer ATP 

860 Key scan routine 

870-950 Character shape data 

960-1020 Screen format data 

1030-1040 Initial values for the C( ) array 

1050-1090 Playing screen set-up 

1 100-1 1 10 Initialize variables 



Protein Level 
Control Routine 
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DIRECTORY OF VARIABLES 1 



Variables 

C() 

AS 

1$ 

A 

AGE 

ATP 

D 

DST 

DX 

DY 

K 

MF ' 
MX 

MY 



RN 
RT 
ST 
TA 
Z 



Functions 

Graphics information 

Input routines 

Legal keys 

Age deviation factor 

Age of the cell 

Amount of ATP administered 

Flag for reason for game termination 

Destination of mitochondrion 

X coordinate of mitochondrion's 

destination 

Y coordinate of mitochondrion's 

destination 

ASCII value of the key pressed 

Motion indicator 

The speed of the mitochondrion on the 

Xaxis 

The speed of the mitochondrion on the 

Yaxis 

The position of the key pressed within 

the list of legal keys 

Random factor: nutrient supply 

Random factor: internal temperature 

Keyboard status 

Temperature deviation multiplier 

Utility loop counter 
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Cell Mates 



REMARKS 



a 



DESIGN FOCUS I 



One of the most challenging tasks on any computer, 
including the Commodore 64, is simulating the exter- 
nal environment— the physical world is very complex, 
to say the least. 

To make our programs more realistic, we often build 
in algorithms which simulate real events. One such 
event is the transfer of energy from one place or pro- 
cess to another. This transfer would be fairly simple 
to program if energy transfer were instantaneous. In 
almost all cases, however, this transfer takes place 
over a period of time. 

In Cell Mates, energy transfer occurs in all pro- 
cesses; heat generation, protein production, etc. To 
handle this intricate pattern of energy transfer, we 
created the algorithm illustrated by the chart on this 
page. This algorithm simulates the real-time delay 
that affects almost any process-control device, 
whether it be industrial or biological. 

The algorithm first determines the value that would 
occur if the energy transfer were instantaneous. This 
is the target value. The current value (the value 
displayed on the indicator) slowly approaches the 
target value. If the target value is not affected by other 
processes that influence energy transfer, such as the 
age of the cell, the current value eventually reaches 
the target value. 

We employ a multiplier (.05) to control the speed at 
which the current value approaches the target. By ap- 
plying this multiplier to the distance between the cur- 
rent value and the target value, we get a fraction of 
the distance between the current value and the target 
value, ((target value - current value) * .05). That fraction 
constitutes the distance that the current value in- 
crements as it approaches its target. 

The beauty of this routine is that the distance bet- 
ween the two values determines how quickly the cur- 
rent value approaches the target. The farther the cur- 
rent value is from the target value, the faster the cur- 
rent value approaches the target value. 



LISTING ANNOTATIONS ! 



Line Nos. 

100-200 Program header 

210-290 Initialize program 

300-320 Main control loop , 

330-350 End of game— option to play again 

360-600 Vital statistics calculations 

610-630 Update indicators 

640-680 Move mitochondrion 

690-740 Update ATP levels 

750-780 Update age counter 

790-820 Read and decode keypress 

830-890 Sound effects routines 

900-960 Check cell's health 

970- 1 1 70 Print end-of-game message 

1 1 80- 1540 Initialize program graphics and screen 

1550-1560 Datd for C( ) array initial values 

1570 Keypress translation data 

1580 Indicator highlights data 

1590-1600 Custom indicator character data 

1610-1780 Sprite shape data 

1790 Screen column data 

1800-1810 Exception characters 

1820-1840 Indicator labels 

1850-1930 Cell model data 

1940-1970 Exit program, option to play again 



Process Control 
Delay Simulation 
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DIRECTORY OF VARIABLES I 



Variables Functions 

C() Values for indicators 

KEYS( ) Key to location translation 

METR( ) Screen offset to start of indicator 

MHST( ) Offset to pointer position 

A$ Message displays 

K$ Inputs 

A Age deviation factor 

AGE Age of the cell 

ATP Amount of ATP administered 

BASE Character for pointer 

BCKGR Screen background color (0) 

BRDR Screen border color (4) 

CBASE Custom character set location 

CCOL Screen color (12) 

D Flag for reason for game termination 

I, II Utility— loop counters 

K Key pressed 

MCHAR Starting character for pointers 

MIT Motion indicator 

NDX Screen offset 

RN Nutrient level random multiplier 

RP Position of pointer in indicator 

RS Pointer character 

RT Random multiplier for temperature 

SBASE Start of sprite shape memory 

SND Sound routine address 

TA Temperature deviation multiplier 

VID Start of screen memory 

X Utility variable 

Z Utility variable 



© Home Computer Magazine 1985 Volume 5, No. 6 



87 



PROGRAMMER'S WINDOW 




The main control loop is the heart of the Apple ver- 
sion of Cell Mates. Simulations and games usually 
have far more intricate control routines than other pro- 
grams, because of the complexity of the interaction 
taking place. Often these programs operate con- 
tinuously, requiring the control loop to update and 
maintain certain conditions in an apparently instant 
process. 

Because a simple routine is much easier to write and 
debug than a complex routine, normally the first rule 
in designing a control routine is to keep it simple. 
Thus, all specialized functions of the program should 
be kept in separate routines away from the main con- 
trol routine. 

For the sake of speed, however, there are times 
when it is better to leave some code in the main con- 
trol routine, rather than in a separate routine. In Cell 
Mates, the key-scan and control code is the hub from 
which all other actions and reactions emanate. It 
therefore makes more sense to place this code in the 
main control routine. 

The main control routine starts by checking 
whether a key has been pressed. If no key has been 
pressed, the program skips the rest of the key-scan 
code and continues with the control loop. 

If a key has been pressed, the program checks to see 
whether the key is legal. If the key is legal, the pro- 
gram continues, otherwise the program branches 
around the rest of the key-scan code as if no key had 
been pressed. The routine now checks to see if the 
selected key is "Q" or "q". If so, the program branches 
to the exit routine. If a different legal key has been 
pressed, the routine uses that key as an indicator of 
the mitochondrion's destination. 

The control routine then checks the MF flag to see 
if the mitochondrion is supposed to be moving. If it 
is, the program calls the routine that moves the 
mitochondrion; otherwise ATP is administered. The 
routine then performs a branch to do all of the cell's 
calculations. Finally, the main control routine in- 
crements the cell's age and displays the update on the 
screen. 



LISTING ANNOTATIONS ! 



Line Nos. 

100-200 Program header 

210-260 Misc. subroutines 

270-300 Load program above high-res screen 

3 1 0-330 Program initialization 

340-360 Sound effects option 

370-450 Main control loop 

460-490 End of game, option to play again 

500-690 Vital statistics calculations 

700-760 End-of-game check 

770-910 End-of-game subroutine 

920-950 Pointer movement 

960-980 Mitochondrion movement 

990-1050 ATP administration 

1 060- 1 140 Sound effects routines 

1 150-1400 Game screen graphics 

1410-1550 Initialize variables 

1560-1590 Data for the graph labels 

1600-1650 C( ) array data 

1660-1720 CALL PRNT routine hexadecimal data 

1730-1760 Data for the high-resolution numbers 

1770-1840 Data for the high-resolution characters 

1850-1880 Sound and shape table data 

1890 Data statement error message 




Main Control Loop 



U EXIT J 



BRANCH TO ROUTINE 

THAT MOVES 

MITOCHONDRION 



ADMINISTER ATP 



£ 



BRANCH TO DO 

CALCULATIONS AND 

UPDATE METERS 



INCREMENT AND 
DISPLAY AGE 



DIRECTORY OF VARIABLES I 



Variables Functions 

A$ Inputs and reading data 

1$ List of legal key presses 

C( ) Values for indicators 

OLD( ) Old indicator values 

P() Graphics coordinates 

A Age deviation factor 

AGE Age of the cell 

AP The amount of ATP administered 

D Flag for reason for game termination 

DST Destination of mitochondrion 

DX X coordinate of mitochondrion 

destination 

DY Y coordinate of mitochondrion 

destination 

HIGH Upper limit used by LIMIT function 

K Key pressed 

LOW Lower limit used by LIMIT function 

NOISE NOISE effects routine address 

MF Motion indicator 

MX Movement along X axis 

MY Movement along Y axis 

OFF Address of sound routine 

P Key index variable 

PRNT Address of PRNT graphics routine 

RN Random nutrient multiplier 

RT Random temperature multiplier 

SOUND Address of SOUND effects routine 

TA Temperature deviation multiplier 

XI Utility variables 

X2 Utility variables 

Y Utility variables 

Z Utility variables 
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remarks: 

Paint tiling on the IBM version of Cell Mates is a plea- 
sant bonus to the graphics commands already built 
into IBM and Tandy BASIC. Paint tiling is an option 
of the PAINT command that allows specification of the 
pixel pattern and colors to be used in the filling pro- 
cess. This useful option allows the programmer to 
design shape interiors and to "dither" several colors 
together for added graphics effects. 

Paint tiling requires a string expression that 
specifies the pixel and color patterns. The width of the 
tile area is one byte (eight bits), as shown in Chart 1 
of the Design Focus. To the right of this diagram are 
the hexadecimal values of each byte. Bits through 
3 make up one hexadecimal character; bits 4 through 
7 constitute the other hexadecimal character. 

The resolution of the screen determines how many 
pixel columns that the tile cam contain. In medium- 
resolution graphics mode 1 (SCREEN 1), it takes two bits 
to define a color. Dividing 2 into the bit width of 8 gives 
us a pixel width of 4— so we can paint a tile that is 4 
pixels wide. Chart 2 illustrates a medium-resolution 
tile; Chart 3 shows the effect when 4 of these tiles are 
placed on the screen. 

In medium-resolution mode there are three colors 
available for the foreground, and one color for the 
background. The chart below lists the colors that are 
available from palette 1 of the COLOR command (see 
your BASIC reference manual for more information 
on the COLOR command). 



Bit 
Pattern 



00 
00 
00 
00 
01 
01 
01 
01 
10 
10 
10 
10 
1 1 
1 1 
1 1 
1 1 



00 
01 
10 

1 1 

00 
01 
10 

1 1 

00 
01 
10 

1 1 

00 
01 
10 

1 1 



Hexadecimal 
Character 


1 
2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
C 
D 
E 
F 



Colors 
Produced 



Background 

Background 

Background 

Background 

Green 

Green 

Green 

Green 

Red 

Red 

Red 

Red 

Brown 

Brown 

Brown 

Brown 



Background 

Green 

Red 

Brown 

Background 

Green 

Red 

Brown 

Background 

Green 

Red 

Brown 

Background 

Green 

Red 

Brown 



Background color is specified with the COLOR statement 
HCM Glossary terms: dither, tile. 



I LISTING ANNOTATIONS | 



Line Nos. 

100-240 Program header 

250-280 Program initialization 

290-380 Main control loop 

390-440 Cell limits check 

460-660 End-of-game option to play again 

660-820 Mitochondrion movement 

830-1030 Cell conditions update 

1040-1 190 Screen indicators update 

1200-1420 . Variable initialization 

1430-1530 Screen initialization 

1640-1590 Cell graphics 

1600-1680 Internal parts graphics 

1690 Indicator graphics 

1700-1710 Data for green area of indicators 

1720-1750 Indicator descriptions 

1760-2080 Program data 



1 DESIGN FOCUS I 

Fancy Graphics 
With Paint Tiling 



BIT 


7 6 


5 4 


3 2 


1 


HEX 
VALUE 


















E6 




























9 


9E 
6B 


































9E 



□■' 



= 1 11=0 

CHART 1— Bit Patterns And Hexadecimal Code 



COLOR PATTERN 



3 2 12 

2 13 2 

1 2 2 3 

2 1 3 2 



IsGREEN 

2=RED 

3=BROWN 



CHART 2— Color TDe Pattern 




CHART 3— Color Screen Pattern 



! DIRECTORY OF VARIABLES! 



Variables Functions 

C( , ) Internal cell coordinates 

MTTO%( ) Mitochondrion shape array 

P( ) Indicator shape array 

A$ Screen display 

AA$ Indicator graphics 

B$ Indicator graphics 

D$ Indicator graphics 

1$ List of legal keys 

K$ Utility 

A Age deviation factor 

AGE Age of cell 

ATP Amount of ATP administered 

B Utility 

D Utility 

Dl Utility 

D2 Utility 

CC Distance for mitochondrion to move 

DONE End of game 

DST Destination of mitochondrion 

DX, DY Mitochondrion motion 

EX.E Export energy 

EX.L Export protein level 

EX.TEMP External temperature 

GX, GY Coordinates of destination 

IN.TEMP Internal temperature 

IPRO Input protein 

MF Mitochondrion status 

MITO.X X coordinate of mitochondrion 

MITO.Y Y coordinate of mitochondrion 

NM Mitochondrion motion flag 

NUT.L Nutrient level 

PRO.E Protein energy 

PRO.L Protein level 

RIBO.E Ribosomes energy 

RIBO.L Ribosomes level 

RN Random nutrient adjustment 

RT Random temperature adjustment 

TA Temperature adjustment 

WASTE.E Waste energy 

WASTE.L Amount of waste in the cell 

X, XI, X2 Utility variables 

Y.Y1.Y2 Utility variables 

Z Utility variables 
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! DESIGN FOCUS ! 



The Atari version of Cell Mates uses the Atari com- 
puter's ability to place machine-language routines in 
a string variable. Although many machine-language 
routines are written for a particular section of memory 
(because they access particular addresses within the 
routine), routines that use the string variable method 
must be relocatable. 

The routine that moves the mitochondrion vertical- 
ly is located in the string ML2$ in line 330. This line 
initializes the length of the string to 30 characters, 
then places 30 characters in the string. The ASCII 
values of these characters actually make up the code 
for the machine-language routine. The Design Focus 
demonstrates how these ASCII characters correspond 
to the machine-language instructions. 

To branch to such a routine, we need to know the 
memory address of the string. Atari BASIC offers a 
convenient way to retrieve the address of the string— 
the ADR function. In line 1 120, ADR (ML2S) returns the 
address of the string ML2$. In this way, the USR func- 
tion transfers program control to the machine- 
language routine: 

H = USR(ADR(ML2$),256 + SGN(MY-DY» 

The variable H is a dummy variable required for 
BASIC syntax— any variable name could be used in 
place of H. The first parameter in the USR function is 
the address of the string ML2S returned from the ADR 
function. The second parameter is a numeric expres- 
sion passed to the machine-language routine for it to 
determine the direction that the mitochondrion 
moves. The low byte of this value is either a 1 or a 255. 
The machine-language routine interprets these values 
as positive or negative, respectively. A negative value 
moves the mitochondrion down; a non-negative value 
moves it up. 

The USR function passes this value to the machine 
language routine by placing it on the stack along with 
the number of parameters being passed and the return 
address of the BASIC program. 

HCM Glossary terms: parameter, stack. 



LISTING ANNOTATIONS ! 



Line Nos. 

100-200 Program header. 

210-250 Title screen 

260-400 Program initialization 

410-470 Main control loop 

480-530 End of program— branch to appropriate 

message routine 

540-770 Vital statistics calculations 

780-840 Check for an end-of-program condition 

850-1050 End-of-game messages, option to play again 

1060-1090 Meters update 

1 100-1 130 Mitochondrion movement 

1140-1210 ATP administration 

1220-1370 Character graphics data 

1380-1430 Cell data 

1440-1460 Data for initial values of C( ) array 

1470-1760 Playing screen graphics 

1770-1780 C( ) array initialization 

1790-1840 Limit values to minimum and maximum 

1850-1920 Death-of-cell special effects routines 



Atari 
Machine Language Strings 



x 

* 



B 



Si 



B 



s s s 



as * tf 

* £ £ 



w 

en 



ess 



ML2$ : 



MEMORY: 



MNEMONIC: 



■ |»lm|q|fr 



$68 



$68 



$68 



$30 



$0C 



$A0 



$00 



$C8 



$B1 



i 



PLA 



PLA 



PLA 



BMI 



SKIP 



LDY 



#$00 



INY 



4 



I DIRECTORY OF VARIABLES I 



Variables 

ML$ 

ML2$ 

A 

AGE 

ATP 

CH 

D 

DST 

DX 

DY 

H 

I 

J.K 

MF 

MX 

MY 

P 

PM 

RN 

RT 

TA 

X 
Y 
Z 



Functions 

Values for indicators 
Utility string for inputs etc. 
Routine to move the character set 
Routine to move the mitochondrion 
Utility variable 
Age of the cell 
Amount of ATP administered 
Rebuilds the character set 
Flag indicating when game is over 
Destination of mitochondrion 
X coordinate of mitochondrion destination 
Y coordinate of mitochondrion destination 
Starts the ML2$ Routine 
Utility loop counter 

Indicates element in C( ) array for limit 
checking 

Mitochondrion movement flag 
Mitochondrion X axis movement 
Mitochondrion Y axis movement 
Key pressed 
Utility variable 

Random multiplier affecting nutrient 
supply 

Random multiplier affecting the internal 
temperature 

Effect that the internal temperature devia- 
tion has on other cell parts 
Used in waste calculation 
Used to read data 
Utility — loop counter 
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The TI version of the NanoEditor uses the POS func- 
tion to control program flow when the user selects a 
particular editing command. The POS function 
searches through a string for a smaller string within 
it, and returns (gives) the numeric value of the 
Position of the smaller string. In this way, line 430 sets 
OP equal to the Position of the S$ (the user's selected 
command) in CMD$ (the legal commands— "ADIEL"). 

As shown in the Design Focus, if OP is not a 1, the 
program prompts the user for the number of the line 
to be Deleted, Edited, Inserted, or Listed (see lines 
460-600 in the program). If OP is set to 1 (for the Add 
command), the program already knows the line 
number to be added, so it branches around this sec- 
tion. In either case, OP then controls the ON-GOSUB in 
line 610 according to the chosen command. 

HCM Glossary terms: branch, string. 



Using the POS Function For Program Flow 

/ GET LEGAL INPUT X 

T 

{ OP « POSCCMDS.SM)""] 




NO 



-z± 



PROMPT USER FOR 
LINE NUMBER 



USE OP IN ON GOSUB TO BRANCH 
TO CORRECT ROUTINE 



V 



\ LISTING ANNOTATIONS - NanoEditor I 



Line Nos. 

100-190 Program header 

200-230 Initialize program 

240-290 Main menu 

300-620 Main editing loop 

630-830 Add a line 

840-950 Delete a line 

960-1140 Edit a line 

1150-1340 Insert a line 

1350-1570 List lines 

1580-2010 File routines 

2020-2140 Print-lines routine 

2150-2240 End program 

2250-3100 Input routine 

31 10-3190 Print-menu routine 

3200-3220 Assure number is three digits 

3230-3270 Set parameters for input routine 

3280-3310 Print line number 

3320-3360 Menu data 

3370-3400 Read keyboard 

3410-3430 Delay loop 

3440-3470 Initialize-program subroutine 



□ 



DIRECTORY OF VARIABLES - common I 



Variables Functions 

A Store the tab position 

A$ Utility variable 

FL$ File name 

I.IT Loop counters 

K Keyboard-input variable 

LI$( ) Array that stores source-code lines 

LN Current line of text 

NI Number of items in current menu 

NL Current number of source-code lines 

PR$ Printer parameter 

S Keyboard status 



! LISTING ANNOTATIONS -Nemo Assembler \ 



□ 



i DIRECTORY OF VARIABLES - NanoEditor 1 



Variables 

B 

C 

C$,CN$ 

CMD$ 

DC 

E 

ESC 

G 

L 

NS 

OP 

R 

RW 

S$ 

SL 

T 

X 

CA,KS,LN$, 



Y.Z 



Functions 

Lowest legal ASCII value for input 

Screen column position during input 

String of possible ASCII inputs 

Possible editing commands; "ADIEL" 

Disk/Cassette flag 

Position of last character input 

Flag used for escape key— (FCTN) 9 

Character read from screen 

Maximum length of input 

Used in input routine 

Option chosen from editing prompt 

Screen row position during input 

Limit on row postion 

Utility string 

Save/Load flag 

Highest legal ASCII value for input 

Current cursor postion 

Utility variable 



Line Nos. 

100-190 Program header 

200-270 Initialize program 

280-460 Program driver 

460-820 First pass 

830-1120 Second pass 

1 130-1 170 Get keypress and return to main driver 

1180-1310 Error routines 

1320-1460 File routines 

1470-1520 Prepare assembler output 

1530-1590 Strip line of remarks and spaces 

1600-1740 More file routines 

1750-1820 Look for a legal mnemonic 

1830-1930 Set up printer 

1940-1960 End program 

1970-2700 Check mnemonics and directives 

2280-2330 Convert a number from binary 

2340-2390 Convert a number from hexadecimal 

2400-2700 Evaluate data field 

2710-2830 Menu routine 

2840-2880 Get a Y or N keypress 

2890-2950 Delay loop 

2960-3030 Initialize-program subroutine 

3040-3050 Mnemonics and assembler directives 



D m DIRECTORY OF VARIABLES -NanoAssembler m 



Variables Functions 

AD( ) Address array 

CA Current address 

EA Ending address of a line of code 

HX$ String of hex characters 

LB Current label number 

LB$( ) Array of labels 

LFLAG Flag used to spot label 

LL Length of source-code string 

N$ Used to convert numbers to decimal 

NM$ Legal numeric-character string 

NN( ) Number of nibbles for mnemonics 

OP Current mnemonic (or op-code) 

OP$( ) Array of mnemonics (or op-codes) 

OT$ Output string 

OU$ Output string 

PR Printer flag 

T$ Temporary string 

TL$ Current source-code line 

V Value of data in right-most field 

X.Y Utility variable 
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n 



REMARKS! 



DESIGN FOCUS ! 



m 

A 

<\ 

© 
SI 



A vital task of the NanoAssembler is translating 
numbers expressed in string variables into numeric 
quantities. The Commodore BASIC VAL function 
makes this task easy by extracting the numeric value 
of a decimal number expressed as a string. The Design 
Focus shows how we use this function to convert 
binary strings to numeric values in line 1400: 
1400 V = 0: FOR IT = TO LEN(T$)- 1: 
V = V + VAL(MID$(T$ 1 IT + 1 , l))*2t(LEN(T$) - IT - 1):NEXT 

The program has already done two things before it 
branches to this subroutine: It has placed the proper 
segment (containing the binary number) of the cur- 
rent element of the LI$( ) array into a temporary string 
T$. Also, it has determined that all characters in T$ are 
either ones or zeros. 

First, V is set to zero. Then, the routine enters a FOR- 
NEXT loop where the value of IT goes from to the 
LENgth of T$ minus 1. Thus, each time through the 
loop, IT+ 1 points to a different character in T$ so that 
the routine can use the MID$ function to extract each 
character of T$. Then the VAL function converts this 
character into a numeric quantity. Finally, the LENgth 
of T$ minus (IT- 1) raised to the power of 2 results in 
the correct multiplier for the weight of each bit. The 
routine adds each value to V in turn, so V contains the 
correct decimal value when we exit the loop. 

HCM Glossary terms: binary, hexadecimal, subroutine, weight. 



\ LISTING ANNOTATIONS -N*noE<mor\ 



Line Nos. 

100-190 Program header 

200-220 Initialize program 

230-280 Main menu 

290-450 Main editing loop 

460-540 Add a line 

550-600 Delete a line 

610-690 Edit a line 

700-770 Insert a line 

780-940 List lines 

950-1220 File routines 

1230-1290 Print routine 

1 300- 1310 End program 

1320-1410 Miscellaneous subroutines 

1420-1600 Command-line input 

1610-1890 Line-input routine 

1900-1960 Keyboard-input subroutines 



i LISTING ANNOTATIONS - NanoAssembler I 



Line Nos. 

100-190 Program header 

200-220 Initialize program 

230-380 Program driver 

390-630 First pass 

640-790 Second pass 

800-870 Error messages 

880-900 Build printer output string 

910-940 Truncate source line to remove remark 

950-1 160 Disk and cassette routines 

1 170-1200 Get op-code 

1210-1240 Set up printer 

1250 End program 

1260-1670 Subroutines for parsing source code 

1680-1710 Keyboard-input routine 

1 720- 1 760 Program-initialization subroutines 

1 770- 1 780 Keyboard-input subroutines 

1 790- 1 800 Sound routines 



\ rfno / 



Converting A 
Binary String To 
A Numeric Value 



|VaVt VAL(MIP$ Ciyr+l,!)) » 2 T (LENQTS) - IT - 1) | 
pTglT + 1 | 




IT > LEN(T$) - r" 

_ YES 
C END ) 



! DIRECTORY OF VARIABLES - common I 



Variables Functions 

A$ Utility variable 

CA Current address 

CL$,RO$ Clear screen character-CHR$(147) 

CO Current column 

CR$ Carriage retum-CHR$(13) 

DN File number 

DV Device number 

E Error number 

E$ Message from disk error channel 

FL$ File name 

I.IT.J.RW.X.Z Loop counters 

DC,K,KE,KE$ Key input variables 

U$( ) Source code array 

LN Current line number 

NL Current number of source-code lines 

RO Current row 

SA Secondary address for I/O 

TE$ Temporary string for line of source 



! DIRECTORY OF VARIABLES -NanoEdttori 



Variables Functions 

B Lowest legal ASCII for input 

C Column for cursor 

C$, CN$ Legal inputs for command 

CM$ Current command 

ES Error number from disk access 

FL( ) Array for different tab fields 

LL$ Current line length 

LN$ Current prompt 

LT Flag for whether a backspace is legal 

N Flag for tab fields 

QU Quote flag 

R.RW Row of input 

S$ Temporary variable for source 

T Highest legal ASCII for input 



D B DIRECTORY OF VARIABLES - NanoAssembler M 



Variables Functions 

AD( ) Array of memory locations 

EA Effective address of next instruction 

HX$ String of hex characters 

LB Counter for parsing source code 

LB$, T$,TL$ Temporary string for line of source 

LF Load/Save flag (LF = 1 means Load) 

LL Line length 

N$ Variable for conversion of decimal 

NM$ String of legal numeric input 

NN( ) Number of nibbles for mnemonics 

OP$( ) Array of op-codes and directives 

OT$ Output string 

OU$ Output string 

PR, PR$ Printer device number 

V.Y Utility variables 
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\ DESIGN FOCUS j 



Saving a NanoAssembler text file with the same 
name as one already on disk presents an interesting 
problem on the Apple computer. As long as the new 
file you are saving is longer (i.e., takes up more space 
on disk) than the old one, there is no difficulty. If, 
however, the file you are saving takes up less disk 
space, you should DELETE the old file, or the data that 
extends beyond the end of your new file will remain 
at the end of the file. 

If you DELETE a file without knowing whether the file 
actually exits, however, you run the risk of a FILE NOT 
FOUND error, which can halt your BASIC program. An 
easy way to ensure that the file already exists before 
you DELETE it, is to OPEN the file— if it didn't exist before 
you executed the OPEN statement it will afterwards. 
In DOS 3.3, you may immediately delete the file after 
you have OPENed it. ProDOS, however, can not DELETE 
an OPEN file. Therefore, you must CLOSE the file before 
DELETEing it. The Design Focus details the BASIC syn- 
tax that performs the entire procedure. 



Saving Over 

An Existing 

File 



.< 



D$ = CHR$(4) 

F$s filename 

DR$= M D n +drlve number 



> 



PRINT D$; N OPEN ":FL$,DR$ 
PRINT D$; M CLOSE - 
PRINT D$j" DELETE ";FL$,DR$ 
PRINT D$; M OPEN ";FL$,DR$ 
PRINT D$;"WRITE w 



S LISTING ANNOTATIONS -NanoEditori 



Line Nos. 

100-210 Program header 

220-290 Main program loop 

300-310 Main menu 

320-380 Main editing loop 

390-450 Add a line 

460-510 Delete a line 

520-600 Edit a line 

610-670 Insert a line 

680-740 List lines 

750-780 Enter a line number 

790-820 File routines 

830-920 Save a file 

930-1020 Load a file 

1030-1290 Enter file name 

1300-1330 Print routine 

1340-1360 Turn printer channel on/off 

1370-1380 End program 

1390-1610 Line-input routine 

1620-1660 Set up menu 

1670-1770 General menu routine 

1780-1810 Get a character from keyboard 

1820-1830 Print error messages 

1840-1940 Initialize program 

1950-2060 Error handler 



DIRECTORY OF VARIABLES -common j 



Variables Functions 

A$, Z$ Character constants 

BL$ CHR$<7), the bell 

CR$ CHR$(13), carriage return 

D$ CHR$(4), wakes up DOS 

DR$ Number of disk drives 

ER Error flag 

ESCS CHR$(27), escape character 

ET$( ), GC, IN$ Keyboard-input variables 

FL$ File name 

HC, HZ, VC Cursor variables 

EI.IT.JI Loop counter 

IX$ Used to get characters from disk file 

LF$, RT$ Cursor left, cursor right 

LI$( ) Array to hold source file 

LN Current line number 

NL Number of source-code lines 

P, XT Pointers used to evaluate strings 

X, XS Utility variables 



DIRECTORY OF VARIABLES -NanoEditori 



Variables Functions 

B73$ String of 73 spaces 

BK$ A single space 

CMD$ Possible editing commands; "ADIEL" 

DN$,UP$ Cursor down, cursor up 

ED$ Legal control characters in edit mode 

EOL Address of EOL routine 

ER$ Error message 

HZ( ) Horizontal position of cursor 

L Maximum length of input 

LO Length of default string for input 

LM Maximum number of source lines 

LV Departure flag for menu routine 

MI Loop counter for menu routine 

MN$( ) Menu options 

MN( , ) Screen locations of menu options 

RW Limit on row position 

S$ Utility string 

TB$ Tab character 



□ 



j LISTING ANNOTATIONS - NanoAssembler \ 



Line Nos. 

100-210 Program header 

220-300 Main program loop 

310-500 First pass 

510-590 Second pass 

600-630 Strip remarks 

640-680 Get op-code 

690-900 Check mnemonics and directives 

910-930 Advance counters and set flags 

940-1070 Evaluate data field 

1 080- 1110 Convert a number from binary 

1 120-1 160 Convert a number from hexadecimal 

1 1 70- 1 200 Turn printer channel on/off 

1210-1290 Error routines 

1300-1410 Load fUe 

1420-1510 Save a file 

1520-1780 Enter file name 

1790-1820 Get a character from keyboard 

1830-1910 Initialize program 

1920-2040 Error handler 



D » DIRECTORY OF VARIABLES - NanoAssembler m 



Variables Functions 

AD( ) Array of memory locations 

CA Current address 

EA Ending address of a line of code 

HX$ String of hexadecimal characters 

LB Current label number 

LB$( ) Array of labels 

LC( ) Label address 

LF Flag used to spot label 

LL Length of source-code line 

N$ Used to convert numbers to decimal 

NM$ String of legal numeric characters 

NN( ) Number of nibbles for mnemonics 

OP Current mnemonic (or op-code) 

OP$() Array of mnemonics 

PR Printer flag 

T$ Temporary string 

TLS Current source-code line 

V Value of data in right-most field 

Y,Z Utility variables 
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IBM PC and PCjr DOS files are easy to access from 
BASIC. With WRITE # and INPUT # statements, moving 
text to and from disk is a relatively error-free process. 
Only the quote character (") is a major difficulty. 

DOS uses this character to delimit the beginning 
and end of each string as it is saved. Therefore, if you 
attempt to save a quote character as part of a string, 
DOS saves only the portion of the string preceding the 
quote and ignores the rest. 

TheNanoEditor and NanoAssembler present a 
unique solution to this problem. These programs 
search each string as it is saved and replace the quote 
with an ASCII 2. (You could use any ASCII character 
normally not found in text.) 

The Design Focus depicts a flow chart of this search- 
and-replace process. First, a QT variable is set to 1 (for 
the first character in the string). Next, the routine 
enters a WHILE loop where the INSTR function searches 
the temporary string S$ for quotes. Upon fiiiding a 
quote, the routine sets QT to the quote's location in the 
string, then replacs it with an ASCII 2. The INSTR func- 
tion then searches the string again, starting at the QT 
location. When there are no more quotes in the string, 
the INSTR function sets QT to 0, and the WHILE loop 
ceases. 

A very similar routine restores the quotes by searching 
the strings as the program reads them from the disk. 



Replacing 
Quotes In 
Disk Files 




YES 
| QT a INSTR(QT,S$,CHR$(34)) | 

NO >VYES 




MID$(S$,QT,1)=CHR$(2) 



DO NEXT LINE 



j IJSTING ANNOTATIONS -Ndrx&mori 



LineNos. 

100-210 Program header 

220-270 Initialize program 

280-360 Main menu 

370460 Main editing loop 

470510 Add a line 

520670 Parse LE$<) string 

580650 Get an U$( ) string 

660680 Get fields from U$( ) 

690740 Display U$< ) 

750860 List lines 

870910 Edit a line 

920960 Delete a line 

9701020 Insert a line . 

10301090 Main file routines 

110O1110 Print-lines routine 

11201160 End program 

11701260 Display a box 

12701550 Input routine 

15601860 Miscellaneous disk routines 



DIRECTORY OF VARIABLES - common! 



Variables 


Functions 


A$ 


Label-field string 


B$ 


Op-code-field string 


c$ 


Comment field string 


F$ 


File name 


i,rr,j 


Utility counters 


INS 


Insert-mode status flag 


K$ 


Key input variable 


L 


Length of input to get 


1$ 


Utility string 


LI*) 


Array to hold source file 


LN 


Current line number 


Ml 


Position of first SP$ delimiter 


M2 


Position of second SP$ delimiter 


M3 


ytility variable 


MC$ 


Lowest legal ASCI value for input 


NL 


Number of source-code lines 


OP 


Option number for edit routine 


P$ 


Prompt for Get-File-Name routine 


s$ 


String returned by input routine 


SP$ 


Delimiter of U$( ) strings 


SP 


Current string position for input 


H,H1,H2,LL,LR 


ASCII for parts of box 


UL,UR,V1,V2 


ASCII for parts of box 


W 


Width of box to be displayed 


X 


Row number 


XC$ 


Highest legal ASCII value for input 


Y 


Column number 



\ DIRECTORY OF VARIABLES -xar**wor\ 



Variables Functions 

BB$ String of 40 spaces 

CS Length of input string 

F Field number 

IN$ String equivalent of line number 

QT Quote flag 

RT Flag for right-most position in input 

SE Rag for insert routine 



! IJSTING ANNOTATIONS -MmoAgamMerj 



LineNos. 

100-210 Program header 

220-250 Initialize program 

260 Program driver 

270-340 First pass 

350-550 Second pass 

560-630 Error routines 

640680 Setuprinter 

^0-700 End program 

710-770 Look for a legal mnemonic 

780-840 Poise line 

850-940 Determine enor 

950-980 Evaluate op-code 

990-1 130 Evaluate data field 

114Q-i400 File routines 

1410-1490 Display-box routines 

1500-1660 Input routine 

1670-1740 Break line into composite strings 



I DIRECTORY OF VARIABLES -NcnaAssembter| 



Variables Functions 

AD%( ) Address array 

ASM Load/Save flag (ASM= 1 means Load) 

CA Current addres 

D Utitilty variable 

DT$ String in Data area left of mnemonic 

HX$ Valid hexadecimal characters 

LB, LBS, LBS( ) Label variables 

LFLAG Set to one if valid label found 

LV( ) Array to contain value of labels 

NM$ Legal numeric characters 

NN< ) Number of nibbles for an op-code 

OP$ String to find mnemonic number 

OP$( ) Legal mnemonics 

OT$,OU$ Output strings 

■V Value of a data string 

XI Row to display source line 
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It is essential that the Atari version of the Nano- 
Assembler assign the correct address to each label it 
encounters in a source file. We do this by placing all 
the labels in one string. As the program executes its 
first pass, it keeps track of the current NanoProcessor 
address in the CA variable. The NN( ) array contains 
the number of nibbles each op-code requires, and is 
used to increase CA to keep it current. In this way, 
whenever the program encounters a label in the Label 
field, it knows the address the label represents. 

During the second pass, the program needs to iden- 
tify each label it encounters in the operand sub-field 
and match it with the correct address. We devised a 
way to store all the labels and their addresses in the 
same string, thus eliminating the need for a separate 
array of addresses: We place the ASCII that corre- 
sponds to the label's address in the string immediately 
following the label. If the label is less than 6 characters 
long, the program pads the remaining area with 
spaces (ASCII 32). Refer to the Design Focus for a 
graphic representation of this scheme. 

The program multiplies the label number kept in 
the variable LB by 7 to calculate an offset into LB$. 
Thus, the code to find the first letter of a label is 
LB$(LB*7,LB*7). Likewise, the address is ASC 
(LB$(LB*7+6,LB$*7+6)>. Because the first label is number 
1, and LB$ is DIMed to 175, a maximum of 24 labels 
is possible, and the first 6 characters of LB$ are not 
used. 



I LISTING ANNOTATIONS -NanoEditori 



LineNos. 

100-190 Program header 

200-230 Initialize program 

240-300 Main menu 

310-430 Main editing loop 

440-530 Add a line 

540-590 Delete a line 

600-700 Edit a line 

710-810 Insert a line 

820-940 List lines 

950-1270 File routines 

1280-1320 End program 

1330-1550 Line-input routine 

1560-1580 Print menu 

1590-1610 Menu data 

1620-1770 Miscellaneous subroutines 

1780-1960 Error handler 



! LISTING ANNOTATIONS -NanoAssembleri 



Line Nos. 

100-200 Program header 

210-240 Initialize program 

250-410 Program driver 

420-710 First pass 

720-930 Second pass 

940-1010 Error routines 

1020-1220 Miscellaneous subroutines 

1230-1240 End program 

1250-1490 Check mnemonics and directives 

1500-1560 Evaluate data field 

1570-1640 Convert from binary 

1650-1770 Convert from hexadecimal 

1 780- 1 840 Number is decimal 

1850-1960 Print menu 

1970-2040 Initialize program 

2050-2130 Enter file name 

2 140-2330 Error handler 



The Structure Of 
The Label String— LB$ 



CHARACTER 

ASCII VALUE 

PREVIOUS LABEL'S 

ADDRESS 

FIRST CHARACTER 

SIXTH CHARACTER 

LABEL'S ADDRESS 
AS ASCII VALUE 

NEXT LABEL 



E 



H 



52 



H 



69 



□ 



32 



□ 







! DIRECTORY OF VARIABLES -common] 



Variables Functions 

A, A$,S$ Utility variables 

DEV$ I/O device 

FL$ Filename 

I.IT Loop counters 

KEY Keyboard-input variable 

LINE$ String to hold source file 

LN Current line number 

NL Number of source-code lines 

X Error number 

Y Line number that error occurred in 



1 DIRECTORY OF VARIABLES -NanoEditori 



Variables Functions 

C$ Legal keyboard input characters 

CH Keyboard input character 

CMD( ) Indexing into command string 

CMD$ Possible editing commands; "ADIEL' 

ESC Flag used tor escape key 

J Loop counter 

LN$ String containing line number 

NM Number of menu options 

RW Loop counter 

TB Utility variable 



D » DIRECTORY OF VARIABLES -NanoAssemblerm 



Variables Functions 

AD( ) Array of memory locations 

CA Current address 

DELAY Loop counter 

EA Ending adress of a line of code 

EXT$ File name extension 

LABLL( ) Array to store length of each label 

LB Index into label string 

LB$ Label string 

LF Holds labels 

LFLAG Flag used to spot label 

LL Length of source code line 

NI.NN Utility variables 

NN( ) Number of nibbles for mnemonics 

OP Current mnemonic (or opcode) 

OP( ) Pointers into opcode string 

OP$ String of mnemonics 

OT$, OU$ Output string 

POWR Loop counter 

PR Output file number 

SQUR Used to convert from binary 

TL$ Current source code line 

T$,VU$ Utility string 

V Value of data in right-most field 

VLU$ Right-most field 
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algorithm - A set of rules or procedures used to 
solve a problem. 

amplitude - The height of a waveform measured 
from peak to peak. 

argument - A parameter that is passed by a BASIC 
function. 

ASCII - (American standard code for information 
interchange) The computer code most commonly 
used to represent upper- and lower-case letters, 
numbers, symbols, and punctuation marks. 

assembler - A program that translates or 
assembles source code Into machine language. 

ATP - (Adenosine Triphosphate) A product of the 
mitochondria that serves as the energy source for 
all cells. 

attack - Rate at which a signal reaches its peak 
level on a traditional adsr envelope generator. 

azimuth - The angular distance of an object 
measured in degrees clockwise (to the right) from 
true north. 

BCD - (Binary coded Decimal) A method for 
representing decimal numbers In binary. 

binary numbers - A base-2 numbering system in 
which the only symbols used are and 1. 

bit - (binary digit) The most basic unit of Informa- 
tion that the computer uses. Each bit is an elec- 
tronic impulse, that, combined with other such Im- 
pulses fed Into the computers. circuitry, forms 
data. 

branch - A departure from the sequential execu- 
tion of program instruction— usually due to the 
test of a condition. 

byte - A sequence of 8 bits used to represent one 
character. 

call - to transfer control to a specified closed 
subroutine. 

component - One of the sine waves that add up 
to produce a complex periodic waveform. 

CONFIG.SYS file - A file on a PC DOS disk that, when 
DOS boots, configures the way that the operating 
system views memory, I/O devices, etc. 

conjunction - The apparent meeting of two 
celestial bodies in the same degree of the zodiac. 

cross-reference - An organized list of items from 
several different sources that refers you to the 
Items folder, card number, or whatever applies. 

cursor - A character or mark shown on the video 
screen to designate where the next character will 
be printed. 

cycle - one complete alternation of a periodic 
waveform. 

decay - Rate at which a signal falls from peak level 
to sustain level on a traditional adsr envelope 
generator. 

declination - The angular distance of a celestial 
body south or north of the celestial equator (the 
plane of Earths equator extending to Infinity). 

dither - To use a combination of dots to simulate 
a tone in black-and-white or color. 

dna - (deoxyribonucleic acid) Nucleic acids local- 
ized in the nucleus of eucaryotic (nucleus-bearing) 
cells or in the lining of procaryotic (without nuclei) 
cells as the molecular basis of heredity. 

DOS - Disk operating System. 

dummy argument - An argument passed purely 
to satisfy the syntax of a statement. 

ecosystem - An ecological community together 
with its environment, considered as a unit. 

endoplasmic reticulum - A convoluted mem- 
brane extending out from the nucleus of a living 
cell. 

envelope - A graphic representation of the 
envelope generator's output as a function of time. 

enzyme - Any of complex proteins produced by 
living ceils that catalyze specific biochemical 
reactions. 

field - A specified area for a particular category 
of data. 

file - a collection of related records (data items), 
treated as a unit. 

flag - A variable or memory location that contains 
a value that represents a condition the program 
needs to test. 



HCM Glossary 

frequency - The rate of repetition of a waveform, 
it Is perceived as pitch in the audio range. 

function - in basic, a statement used to return a 
value. The value often depends on the type of argu- 
ment passed to it. 

fundamental - The principal frequency of a 
waveform, in the audio range, it Is the perceived 
pitch. 

Colgi apparatus - An organelle that packages and 
transports materials in a living cell to be secreted 
to the plasma membrane for internal use or 
expulsion. 

hard-code - To specify the values of variables or 
constants within the program code itself so that 
they are not subject to change by user input. 

harmonic - A component of a periodic waveform, 
its frequency is a positive Integral multiple of the 
fundamental frequency. 

hexadecimal numbers - A base-16 numbering 
system using decimal digits through 9 and the 
letters A through F. 

high bit - The left-most bit of a binary number; 
e.g., the eighth bit of a byte. 

horizontal plot position - The horizontal position 
on the screen at which the next point will be 
plotted. 

index - to selectively choose and organize a group 
of data (or an organized list of items that refers you 
to the items folder, page number, or whatever 
applies). 

interrupt request - A signal that directs the com- 
puter away from the program sequence. 

iteration - One complete cycle through a process 
that Is repeating. 

level of recursion - A routines depth into a recur- 
sive process. 

linear - An even progression from one state to 
another with no deviation in course. 

logic operator - A BASIC function used to perform 
a logical operation. 

lysosome - A cells waste disposal unit— basically 
a sac pinched off of the Golgl apparatus. 

machine language - A native language of the 
microprocessor in a computer expressed in terms 
of binary ones and zeros. 

mask - A fixed group of characters used to con- 
trol the retention or elimination of parts of 
another pattern of characters. 

merge - to combine two or more files, or portions 
of files, into one. 

metabolism - The physical and chemical processes 
of an organism that produce energy and result in 
the production, maintenance, and destruction of 
life. 

MIDI - (Musical instrument Digital interface) 
specified protocols for transmitting digital infor- 
mation from one synthesizer, sequencer, com- 
puter, signal processor, etc., to another. 

mitochondrion - An organelle that produces ATP. 

mnemonic - A code or symbol that helps people 
remember something specific—usually made up of 
letters from the woVd or phrases It represents. 

nibble - 4 binary digits (bits) of data-a half byte. 

noise channel - The channel responsible for pro- 
ducing noises. 

nucleus -The central core of a cell containing both 
the cells heridltary dna, and the message-bearing 
rna (ribonucleic acid). 

organelle - A specialized part of a cell with a 
specific organ-like function. 

overtone - A frequency component of a 
waveform, that Is higher than the fundamental. 

op-code - (operation code) The part of a machine 
instruction that tells the computer which function 
to perform next. 

parameter passing - sending (giving) a parameter 
to a particular process. 

periodic noise -one of 4 pulse waves produced 
by the TI-99/4A sound chip. 

precession - A gradual change in the angle of the 
Earth's axis due to "wobbling" in the Earth's 
rotation. 
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proper motion - Apparent movement over time 
of a star in the celestial sphere due to the actual 
motion of both the star and our sun through space. 

protein - Any of several complex compounds that 
are required for all life processes. 

pulse wave - A wave that alternates Instantan- 
eously between the two DC volage levels. 

pulse width - The percentage of time that a cycle 
of a pulse wave spends In the higher of its two 
voltage states. 

RAM - See Random Access Memory. 

Random Access Memory (RAM) - The set of hard- 
ware locations In a computer where programs and 
data are stored. 

random number generator - A circuit within the 
computer that generates pseudo-random 
numbers. 

record - A collection of information consisting of 
one or more related items. 

recursion - A seemingly circular process in which 
a procedure calls itself repeatedly. 

release - Rate at which a signal falls from sustain 
level to zero level on a traditional adsr envelope 
generator. 

respiration - The process of yielding energy from 
oxidative reactions in living cells, 

resultant - The complex periodic waveform 
resulting from the addition of two or more sine 
wave components. 

ribosome - An organelle consisting of protein and 
ribonucleic acid (RNA) that catalyzes the construc- 
tion of proteins. 

right ascension - The east/ west coordinate of a 
celestial body along the celestial equator. 

ring modulation - Mathematically combining two 
frequencies by outputtlng their sum and dif- 
ference and suppressing the original frequencies. 

sector - on magnetic storage medium, a section 
of a track constituting a unit of data storage. 

SID - sound interface Device chip In the com- 
modore 64 computer. 

sine wave - A single frequency oscillation that pro- 
duces a pure fundamental waveform without 
harmonics. 

statement separator - A character that separates 
basic statements. 

string - A consecutive set of similar data items— 
usually bits or characters. 

subroutine - A program segment or module that 
performs a specified function (e.g., debugging). 

sustain - The level of a signal after attack and 
decay, and before release on a traditional adsr 
envelope generator. 

symbiotic - Two or more different organisms in 
a close association that Is of mutual benefit 

synchronization - The linking of two oscillators 
such that the start one oscillator cycle triggers the 
start of the second oscillators cycle. One oscillator 
acts as the master and the other acts as a slave. 

text file - A file containing textual information 
that is stored in ASCII format. 

tile - A technique employed in conjunction with 
the IBM basic paint command that allows the user 
to place a specified graphic pattern onto a par- 
ticular area of the screen. 

tod - An acronym for the Time-Of-Day clock on the 
Commodore 64 computer. 

video buffer - A section in memory reserved for 
video processing. 

waveform - 1. A graphic representation of the 
shape of a wave. 2. A signal with periodic fluctua- 
tions produced by an oscillator. 

weight - The value of a bit determined by its 
position. 

white noise - Random acoustical or electrical 
signals In which the intensity is the same at all fre- 
quencies within a given band. 

zodiac - An imaginary belt in the sky about 18 
degrees wide along which the sun and all planets 
except Pluto appear to travel. 
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CELLMATES 



ATARI 800/800XL/130XE 



100 IreIm ************** f 50 ? "We s c c t r l <W ; : POKE 53277 ,0 : POS I 


l 110 REM * CELL MATES * T I ON 13,10:? ' QU I T ? ( Y/N)" :GE T #2, A 


n 120 REM ************** : A$=CHR$ ( A) : IF A $ = " THEN 500 


M 130 REM COPYRIGHT 1985 s 510 I F A$ <> ' N • AND A $ <> - n AND A $ <> Y 


r 140 REM EMERALD VALLEY PUBLISHING CO. AND A$<>"y. THEN 500 w% ^„ r , R B « „ 


D 150 REM BY WILLIAM K. BALTHROP b 520 IF A $ = " N " OR A $ = " n " T H E N P OK E 5 5 9 , 


L 160 REM AND THE HCM STAFF :GOSUB 1480:GOSUB 1070:POKE 559,42: 


K 170 REM HOME COMPUTER MAGAZINE POKE 5 3 2 7 7 , 3 : R E T URN „„„ m „ 


F 180 REM VERSION 5.6.1 o 530 POSITION 9,16:? "BETTER LUCK NEXT T 


p 190 REM ATARI BASIC FOR THE 800, I ME " : P OS I T I ON 1 7 , 1 8 : ? " B Y E I " : FOR 1 = 


z 200 REM 800XL, AND THE 130XE 1 TO 1000:NEXT I : ? US R ( 5 8 484 ) 


c 210 REM *******TITLE PAGE******* L 540 REM CALCULATE VALUES „ t ^ m 


v 220 GRAPHICS 2:POKE 7 5 2 , 1 : POS I T I ON 5,5: d 550 A= ( 3 3 3 4-AGE ) * 3 E-0 4 : I F AGE / 1 0= I NT ( AG 


? #6-"CELL MATES" E/10) THEN RN = RN + RND ( ) * 1 6-8 : R T = R T + 


T 230 ? :?'" (PRESS <RETURN> TO CONTIN RND(0)*5-2.5 


UE « a 560 IF MF=2 THEN GOSUB 1110 


i 240 SOUND ,PEEK(53770) ,10 , 2 : IF PEEK(76 J 570 C ( 7 , 2 ) =C ( 1 4 , 1 ) * 1 . 3-AB S ( C ( 9 , 1 ) -50 ) * 


4)=255 THEN 240 . 2-AB S ( C ( 1 , 1 ) * . 2 ) : I =7 : J = 2 : GOS U B 1 


r 250 POKE 764 , 255 : SOUND , , , : GR AP H I CS 820 


i 580 C( 7 , 1 )=C( 7 , 1 )+(C( 7 , 2)+RN-C( 7 ,1 ) ) *0 . 


k 260 REM **** * * * INI T I AL I ZE* * ** * * * 02:J=1:GOSUB 1820 


x 270 POKE 559,0 m 590 C ( 8 , 2 ) =C ( 1 4 , 1 ) * 1 . 5-AB S ( C ( 1 , 1 ) -5 ) * 


p 280 DIM C(18 2) ,A$(40) . 3-AGE / 1 00 : I =8 : J=2 : GOS U B 1820 


y 290 OPEN #2,4,0 "K:":? "JTESC CTRt <«•; y 600 C ( 8 , 1 ) =C ( 8 , 1 ) + { C ( 8 , 2 ) -C ( 8 , 1 ) ) * . 2 : 


f 300 REM ***ML ROUTINE TO MOVE CHARACTER C ( 1 , 2 ) =5 0+ { C ( 1 4 , 1 ) -5 ) * . 2 : C ( 1 , 1 ) 


SET*** =C(10,1 )+(C(10,2)+RT-C(10,1 ) )/10 


j 310 DIM ML$ ( 40 ) :ML$="hE»CTR L ElLtCTRL e p 610 I =1 : J=1 : GOSU B 1820 „ , „ „ « x , * 


■ N(-tE»CTRL BIEtCTRL ElM)tCTRL .1JTC A 620 C ( 1 1 , 1 ) =C ( 1 1 , 1 ) + ( C ( 1 1 , 2 ) -C ( 1 1 , 1 ) ) * 


TRL ElOlNfCTRL QlLHP V f M f OhtC T R L . «E . 1 : C ( 1 3 , 1 ) =C ( 1 3 , 1 ) + ( C ( 1 3 , 2 ) -C ( 1 3 , 1 ) 
ICTRL -DiEPpEfCTRL '.i 8 > * 5 i 1 „ „ , „ „ „ . . , „ , ^ B «* „ , „ E -» % «■ 


w 320 REM ***ML ROUTINE TO MOVE MITOCHOND v 630 C ( 1 5 , 1 ) =C ( 1 5 , 1 ) + ( C ( 1 5 , 2 ) -C ( 1 5 , 1 ) ) * 


RIA VERTICALLY*** . 1 : C ( 1 7 , 1 ) =C ( 1 7 , 1 ) + ( C ( 1 7 , 2 ) -C ( 1 7 , 1 ) 


l 330 DIM ML2$ ( 30) : ML 2 $ = " h h h JTC T R L L«E Ki" )*0.1 „.** * x .. • ,. » . „ , 


CTRL .lFHlPfCTRL 1 HlfCTRL QlPHEfCTRL D 640 C ( 1 6 , 2 ) =C ( 1 6 , 2 ) + ( C ( 1 1 , 1 ) +C ( 1 3 , 1 ) + C ( 


pfEwitcin .IE tciBL ,wctrl HllPH 1 5 , 1 ) +C ( 1 7 , 1 ) ) * . 2 : I = 1 6 : J = 2 : GO S U B 


ICTRL QtPfCTRL HtEtCTRL PIE»E»CTRL 1820 „ , „ - ,. , % « 


^« r 650 C( 16 , 1 )=C( 16 , 1 )+(C( 16 , 2 ) -C ( 16 , 1 ) ) *0 


G 340 POKE 106 , PEEK( 106)-8 :CH=(PEEK ( 106)+ .1 t -..«,- 


4)*256:POKE 756 ,CH/256 : A = USR ( ADR (ML G 660 C ( 9 , 2 ) =C ( 1 , 1 ) + ( C ( 1 1 , 1 ) +C ( 1 3 , 1 ) +C ( 1 


$)):FOR I=CH + 768 TO CH4-887:READ A 5 , 1 ) +C ( 1 7 , 1 ) -60 ) * . 1 : I =9 : J = 2 : GOS UB 


t 350 POKE I,A:NEXT I : CH=CH / 2 5 6 : POK E 106, 1820 . 




APHICS 0:POKE 54279 , PM/256-2 : POKE 5 T A = 1 -AB S ( C ( 9 , 1 ) -5 ) * . 2 


59,42 w 680 C ( 1 2 , 2 ) =C ( 1 2 , 2 ) +C ( 1 1 , 1 ) * . 3 * A * T A-5 


r 360 ? Initializing...." 0/ (c ( 8 , 1 )+o . 1 ) *o . 02 : 1=12 : j = 2 : gosub 


l 370 POKE 208,128:POKE 2 9 , PM/ 2 5 6 + 1 : PM=P 1820 „<.«••*. ~.«~ -, ^ ,- •» ^ 


M-128:FOR I=PM TO PM+639:POKE I,0:N h 6 90 C ( 1 1 , 2 ) =C ( 1 1 , 2 ) * . 98 : C ( 1 2 , 1 ) =C ( 1 2 , 1 


EXT I )+(C(12,2)-C(12,1 ) )*0.01 


G 380 FOR Z = TO 512 STEP 128:READ Y : FOR I 700 C ( 1 4 , 2 ) =C ( 1 4 , 2 ) +C ( 1 3 , 1 ) * A * T A * C ( 1 8 , 1 


I=PM + Y + Z TO PM + V + 7 + Z : READ A:POKE I, ) * 5 . E-0 3-C ( 1 4 , 1 ) * . 6 : I =1 4 : J = 2 : GOS 


A:NEXT I:POKE 704,54:POKE 53277, 3:N UB 1820 ... * m * 


EXT Z i 710 C(18,2 ) =C ( 1 8 , 2 ) -C ( 1 4 , 1 ) *0.04:C(14, 1 


g 390 POKE 704,116:POKE 705,106:POKE 706, ) =C ( 1 4 , 1 ) + ( C ( 1 4 , 2 ) -C ( 1 4 , 1 ) ) * . 5 : C ( 


56:POKE 707 , 104: POKE 623 ,8 : POKE 710 1 3 , 2 ) =C ( 1 3 , 2 ) * . 98 


?15:POKE 709,0:MY = 20 w 720 C ( 1 6 , 2 ) =C ( 1 6 , 2 ) -C ( 1 5 , 1 ) / 1 • T A : I =1 6 : 


G 400 POKE 559 ,0 :D = :GOSUB 1480:GOSUB 178 J = 2:GOSUB 1820 „*■„.,.. - 


0:GOSUB 1070:POKE 559,42 a 730 C ( 1 5 , 2 ) =C ( 1 5 , 2 ) * . 9 6 : C ( 1 6 , 1 ) =C ( 1 6 , 1 


e 410 REM *******MAIN LOOP******* ) + ( C ( 1 6 , 2 ) -C ( 1 6 , 1 ) ) * . 5 


T 420 ON PEEK( 764)=255 GOTO 450:GET #2,K: u 740 ON MF GOS U B 8 40 , 1 1 1 


K = K-128* (K>127) :K = K-32* (K>95) :K = K-K d 750 X = SQR ( C ( 1 2 , 1 ) * C ( 1 7 , 1 ) ) * T A * A * C ( 7 , 1 ) * 


*(K>95):ON K<65 GOTO 450 2 . E-0 3 + C ( 8 , 1 ) * 5 . E-0 3 : I F X>C(12,1) 


z 430 P=(K = 77 )+2* (K = 71 )+3* (K = 76)+4* (K = 82 ) *0.05 THEN X = C ( 1 2 , 1 ) * . 5 


+5*(K=78)+6* (K=81 ) : ON P=6 GOSUB 500 b 760 C ( 1 8 , 2 ) =X+C ( 1 8 , 2 ) : I =1 8 : J=2 : GOS U B 18 


P 440 IF P<6 AND P>0 THEN D S T = P : DX = C ( P , 1 ) 20 «',.,.. „ 


:DY = C(P , 2) : ATP = 0:MF = 2 f 770 C ( 1 7 , 2 ) =C ( 1 7 , 2 ) * ( 1 -C ( 1 2 , 1 ) * 5 E-0 4 ) : C 


P 450 ON MF GOSUB 1 1 50 , 1 1 1 : GOS U B 550 ( 1 8 , 1 ) =C ( 1 8 , 1 ) + ( C ( 1 8 , 2 ) -C ( 1 8 , 1 ) ) * . 


u 460 GOSUB 1070:SOUND , 1 2 8 , 1 , 4 : GOSUB 7 05:RETURN 


90:SOUND 0,0,0,0 J 780 REM ******* END ?**•*** * 


o 470 IF D=0 THEN AGE=AGE+1 : POS I T ION 27,1 z 790 IF C(16,1)>=98 THEN D=1:GOTO 840 


•? AGE::GOTO 420 H 800 IF C(7,1)<5 THEN D=2:GOTO 840 


h 480 REM ***END*** o 810 IF C(9,1)>69 OR C(9,1)<31 THEN D=3 : 


j 490 GOSUB 1860:GOSUB 1780:ON D GOTO 860 GOTO 840 


17890,920,950,980 a 820 IF AGE>3000 THEN D = 4:GOTO 840 
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D1110 |PRINT*THE CELL 








f^fffffl 


COMMODORE 64 ■ 


TEtedPERlATURE HAS EXCE D1560 foATA 1,193,193 


49 , 49 , 13 , 13 , 7 , 7 


| EDED" : PRINT'SAl 


? ETY LIMITS RESULTING T1570 DATA 0,0,0,255 

0,0,0,0, 24$ , 241 


255 ,192,192, 192 ,0,0, 
* , 31 , 31 , 24 , 248, 248 , , 


i ' » 


| B1120 PR INT" I N A BREJ 


IKDOWN OF ALL FUNCTI 0,0 




ONS" : RETURN 


T1580 DATA 40, 60, 40, f 


SO , 40 , 100 ,155, 100 ,153 


! T1130 PRINT"THE CELL 


WAS NOT ABLE TO REPR ,57,96,79,1,1,! 


»0 , 50 


ODUCE" 


B1590 DATA 50,50,50,! 


lO , 50, 50 ,0 ,0 , 50 , 50 , 10 


V1140 PRI NT "WI THIN 11 


rs NORMAL LIFESPAN." , 1 , 3 5 , 3 5 , 2 , 2 C 


1,0,0,15,15,50,50 


H1150 PRINT'tCRSRDOWf 


JIBETTER LUCK NEXT TI E1600 DATA 2,3,1,5,-1 


, 4 


! ME I " : RETURN 


I 1610 DATA 13,4,13,4, 
rULATIONS, YOU ' VE" : PR ,10,7,0,0,1,7,1 


6,6,6,6,0,0,16,1,0,0 


w1160 PRINT" I ICONGRA1 


1,0,16,1 


INT'DIVIDED THI 


: CELL!!" U1620 DATA 0,1,128,0, 


6 , 192 , , 10 , 96 , , 25 , 4 


! " W1170 PR I NT " tCR S R DOWh 


r«YOUR SCORE IS " ; ( 3 8 , , 3 6 , 1 5 2 , , 9 C 


(,88,0,145,80,1,137,8 


OO-AGE ) *10 : RETl 


rRN 




! X1180 PRINT"tSH I FT CI 


R«" :GOSUB1460 T1630 DATA 2,69,96,6, 


37 , 64 , 9 , 21 , 128 , 24 , 14 


11190 FORZ=1T024 : PRI* 


IT" 9 ,0 , 36 , 86 ,0 , 98 , 
" ; : NEXT 


84,0,81 ,88 ,0 ,201 ,80 , 


c1200 FORZ=56256T0562 


!95 : POKEZ , CCOL : NEXT a 1640 DATA 165,160,0, 


69,192,0,53,128,0,23 


p1 210 FOR 1=1 TO 5 : PC 


)KE 11 31 + 1 , 32 : NEXT ,0,0,12,0,0,0 




A1220 FOR 1=0 TO 18:1 


tEAD C( I , 1 ) ,C( I , 2 ) :NE N1650 DATA 126,28,7,1 


26,126,15,124, 227 , 27 


XT I : FOR 1=0 TC 
I 
v1230 NDX=1366:FOR 1= 


> 5:READ KEYS(I):NEXT ,19 3,131,27,195 
■2 TO 12 STEP 2:METR( T1660 DATA 54,60,24,1 


.,3,51,198,6,54, 102 , 1 


02 , 24 , 48 , 204,0 , 227 , 1 


I )=NDX : NDX=NDXH 
6 
D1240 NDX=1466:FOR 1= 


-120:NEXT:METR(1)=124 40, 1,207, 12, 7, 7 

= 3 TO 11 STEP 2:METR( u1670 DATA 224, 192, 18 
■120: NEXT 5, 30, 195, 142, 63 
OKE METR ( I ) ,MCHAR+9 : Y1680 DATA 30,15,206, 


8 , 24, 28,48,48,112 ,96 


12 , 193 , 129 , 140 , 193 , 13 


I )=NDX : NDX=NDXH 


F1250 FOR 1=1 TO 12:F 





PPi^P^ 


FOR I 1=1 TO 14 


U1690 DATA 0,0,0,3,25 


2,0,14,86,0,26,75,0, 


SSBBIBg 


B1260 POKE METR(I)+II 


, MCHAR:NEXT:POKEMET 52,129,128,48,5 


2,128,106,36,192,6 6, 


R( I )+15 , MCHAR + 1 


8:NEXT 67 




i^^^^^p 


H1270 FOR 1=0 TO 4 : PC 


>KE 53248+1 *2 , C( 1+1 , 1 H1700 DATA 64,76,8,64 


1,193,136,96,178,17,1 


p^p^^^ 


) : POKE 53249+1 * 


2,C(I+1,2):NEXT 60, 196, 2, 32, 192 


,128,96,76,17,64,66, 


PffiF nlBl 


z 1 280 FOR 1=1 TO 1 2 :N 


IHST ( I , 1 )=1 :MHST (1,2) 1 




wMm 


=128 : NEXT 


Y1710 DATA 64,97,113, 


192,32,10,128,55,33, 


X1290 FOR 1=1 TO 12 : B 


EAD Z:NDX=55296+(MET 128,24,147,0,12 


,122,0,7, 252 ,0,0 


lifijiliii 


R( I )-1024)+Z-1 : 


READ Z T1720 DATA 0,0,0,0,0, 


0,66, 16, 128, ,131, 57,1 


%JMi 


K1300 FOR I I=NDX TO » 


DX+( Z-1 ) : POKE II,5:N 9 2,0,0,0,0,0,8, 


57 , 206 ,12,16,132 


j EXT I I : NEXT I 


O1730 DATA 72,0,0,192 


,0,0,64,4,33,8,14,11 




D1S10 POKE 53287, 5:PC 


IKE 53288, 6:POKE 5328 5,140,0,0,8,0,0 


,0,115,156, 224 ,33,8, 




9 f 7:POKE 53290, 


2:POKE 53291,4 64 




il ssss jlP^ 


W1320 FOR I=SBASE TO 


SBASE+319 : READ Z : POK M1740 DATA 0,0,0,0,0, 


0,0,0,0,0,0,0,0,0,0', 


M^^f 


E I , Z : NEXT I 







P1330 FOR 1=0 TO 4:PC 


KE 2040+1 , 224+1 : NEXT J1750 DATA 255,255,25 


5 , 255 , 255 , 255 , 255 , 25 




:POKE 53264,0:? 


OKE 53275,0 5,255,224 

TEP 3 : Z=VID+( I *40 ) : F N1760 DATA 0,7,224,0, 




M1340 FOR 1=0 TO 24 S 


7 , 224 ,0,7, 224 ,0,7,22 




OR I I=Z TO Z+39 
*T 


: POKE II,67:NEXT:NEX 4,0,7,224,0,7,2 
AD Z :NDX=0 : X=( 1=1 ) *- D1770 DATA 224,0,7,22 


24,0,7,224,0,7,224,0 


ips^ilii 


N1350 FOR 1=1 TO 4:RE 


4,0,7,224,0,7,224,0, 




107+( 1=3) *-107+ 
5 

i Hi 360 FOR I I=Z TO Z+( 


(I=2)*-115+(I=4)*-11 7,224,0,7,224,0 

55 
24*40) STEP 40:IF ND a1780 DATA 255,255,25 


, 7 , 255 , 255 , 255 , 255 , 2 


5 , 255 ,0 


p^i^i^^ 


! X=3 THEN POKE I 


I+VID , X :NDX=1 :GOT013 A1790 DATA 0,20,21,39 






80 


J1800 DATA 0,112,39,1 


10 , 960 ,109 , 999 ,125,2 


in pBB| 


N1370 IF NOT(NDX=3) T 


HEN POKE II+VID,66:N 1,114,980,113,9 


81 , 113 , 380 , 110 , 20 ,67 


|r4% 


i DX=NDX+1 


Q1810 DATA 120,66,240 


, 66 ,121 , 32 , 241 ,32 

S " , "AGE : " , "NUTRI ENT 




I Y1380 NEXT:NEXT 


Z1820 DATA "CELL MATE 


CJ'm 


Q1390 FOR 1=1 TO 13:R 


EAD Z:READ X:POKE Z+ S", "IMPORT PROT 


EIN" " INTERNAL TEMP" 
TEMP*,"RIBOSOME ENER 




VID , X : NEXT : FOR 


1=1 TO 2:READ K$ O1830 DATA "EXTERNAL 




v1400 FOR 11=1 TO LEN 


(K$):Z=ASC(MID$(K$,I GY" , "RI BOSOMES" 


, "EXPORT ENERGY" 


M gl ^^^ 


I,1)):IFZ>63T 


HEN Z=Z-64 Y1840 DATA "EXPORT PR 


OTE IN", "WASTE ENERGY 




j A1410 POKE VID+I*40+2 


3+ii,z:next:next:for ","waste","prot 


EIN ENERGY" , "PROTE IN 


WimlMS, 


1=1 TO 12 : READ 


K$ :NDX=METR( I )-39 




I^tH 


A1420 FOR I 1=1 TO LEN 


( K$ ) : Z=ASC(MID$ (K$ , I V1850 DATA 112,64,64, 


64, 64, 64, 110 ,32 , 32 ,8 




I,D) 


1 , 64, 64, 64, 64, 6 


4,64,110,32,32 




P1430 Z=Z+(Z>64)*64:P 


OKE NDX , Z : NDX = NDX + 1 : H1860 DATA 66,81,64,6 


4,64,32,109,64,110,1 




NEXT : NEXT 


16 , 112 , 64 , 64 , 64 

R 11=1 TO 19:READ Z: w1870 DATA 66,76,111, 


, 64 , 64 , 125 , 32 ,32 




N1440 FOR 1=1 TO 8:FO 


111,111,82,32,32,66, 


POKE VID+I*40+I 


1+1 , Z :NEXT :NEXT 116,109,83,119, 


80 , 111 , 122 ,80 , 32 , 32 




K1450 POKE 53269 , 31 : R 


ETURN 11880 DATA 109,64,64, 


64 , 64 , 125 , 32 , 102 , 102 


'^W& 


Y1460 PRINT "ISHIFT C 


LR1I12 CR S RDOWNf I N I T ,10 2,111,111,11 


1,111,111,111,122,32 




I AL I Z ING. . 


,32 ■ 




WISm 


V1470 POKE56334,PEEK( 


56334) AND254: POKE 1, c1890 DATA 112,64,64, 


64 , 64 , 64 , 64 , 102 , 102 , 


PEEK ( 1 ) AND251 


102 , 64 , 64 , 64 , 11 


0,32,32,32,32,32 j 


^^^^^^m 


L1480 NDX=CBASE : FOR I 


=0 TO 2048:POKE NDX, 11900 DATA 109,67,64, 


64 , 110 ,32,32,112,125 ' 




PEEK ( 53248+1 ) : N 


DX=NDX+1 :NEXT ,109,64,110,32, 


109,64,64,110,32,32 


B1490 POKE 1 , PEEK (1)0 


R4 : POKE56334 , PEEK ( 56 G1910 DATA 112,64,64, 


64,125,32,32,66,32,1 


334)OR1 


12,64,12 5,32,11 


2,110,32,66,32,32 


X1500 NDX=CBASE+8*MCH 


ARS:FOR 1=1 TO 27:RE t1920 DATA 109,64,64, 


64 , 64 , 64 , 64 , 125 , 32 , 1 


AD Z : POKE NDX , 2 


55 09,64,64,64,125 

OKE NDX+I I , Z : NEXT II J1930 PR I NT £ tHOME«t3 


, 109 ,64,125,32,32 


G1510 FOR I 1=1 TO 6 : P 


CR S R R I GH T* " J "QU I T (Y 


J1520 POKE NDX+7,255: 


NDX=NDX+8 : NEXT I /N)?"; 




B15S0 FOR 1=0 TO 23:R 


EAD Z:POKE CBASE+648 S1940 GETA5: IF A$="Y 


" THEN RETURN 


+ 1 , Z : NEXT 


N1950 IFA$ <> "N" THE 


N1930 


G1540 POKE53272,(PEEK 


( 53272 JAND240 )+12 : PR a1960 D=0 : PRINT"»HOM 


E*»3 CRSGR1GHT1V1 1 S 


INT "ISHIFT CLR 


*";:return Ih r f t *fir : reItuIrn 


T 


Q1550 DATA 0,192,192, 


48 ,48 , 12 , 12 , 3 , 3 , 128 , 


HCM 


224, 224, 117 6, 176 


, 140 , 140 , 131 , 131 I 
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RO. ENERGY * * PROTE I 
hhhhh I % * i hhhhhhhhhhh 

11030 DATA 22,6,22,52,104, 
, , 50 , 50 

N1040 DATA 50,50,50,50,50, 
,10,35,35,20,20,0,0, 

E1050 CALL CLEAR :: RESTOR 
CHAR (1,31,116,96): : 
: READ A$ : : DI SPLAY 

P1060 CALL MAGNIFY(S) : : CA 
4 , 14 , 6 , 22 , #2 , 128 , 5 , 5 
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56,95 Canada — SI 0.95 Foreign Airmail 
{Non-purchaser, non- subscriber price: $12.95) 
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Your Subscription will begin with the up-coming new issue, 
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Office Use Only 
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SP02561185 



For Apple II Family, C-64, IBM PC & PCjr users 




An Attractive 

Library-Storage 

Slipcase 



ON DISK Revue™ Volume 1 

• 10 Complete Programs On A Ready-To-Run Disk 

• Exciting Activities For The 
Entire Family— At An Affordable Price 

• Entertainment, Productivity & Education 
Plus Valuable Programming Secrets 



64-page 

Full-Color 
Book 



Valuable Proof-of-Purchase 
Coupon For Gift Redemption 



ABLE 





CONTENTS 
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Boolean Brain 
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3. 


Savings Planner 
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9. 
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10. 
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ONLY $14.95 
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Protective Pouch 



AS LOW AS $1. 83 
EACH MAGAZINE! 
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For Magazine 

Contents 
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"Shopping List" 
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Opposite Page 
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A Back-issue /Software Bonanza of 



At unbeatable Prices 



The original 99'er Magazine and 99 T er Home Computer Magazine were the forerunners of the 

present-day Home Computer Magazine. Each of these magazine back issues—exclusively 

covering the Texas Instruments TI-99/4A— is now available with your choice of either a 

floppy disk or a cassette tape that contains all the programs in that issue. 

12 MAGAZINE & MEDIA SETS 
SAVE UP TO $44 

# SPECIAL MIX OR MATCH BONUS # 
—WHILE SUPPLIES LAST— 

You will receive a 
FREE Simon's Saucer™ package 
—A $12.95 Premium Value- 
when your order includes at least 12 items 
from this Back Issue offer 
(either 12 media, 12 magazines, 
or 6 of each). 





These 2 Magazine Issues Are 1 
Out Of Print 




Tapes And Disks Are Still [£* 
Available Jg^ 


5ML-V 






mgQ ^uv.ijjr 




m 




A quality, ready-to-run 
game on cassette tape. 

A durable and attractive 
ring-binder collector's case 
for your software library, 

A complete, easy-to-use 
programming lesson on a 
deck of colorful flip cards. 




MAGAZINES OR MEDIA MAY BE ORDERED SEPARATELY 

To Order, Use Order Card On Other Side Of This Page. 




Offer & Prices Subject To Change Without Notice. 
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Magazine 


3.95 
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7.50 


Media 
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7.95 
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10.95 


Magazine/Media Set 


9,90 


12.95 


13.95 


17.50 



SEE PAGES 2 & 3 FOR ALL INDIVIDUAL CONTENTS 





jr 



PCjr Disk Expansion Kit 

Add A Second Disk Drive To Your PCjr 
for $49.95 plus 3,50 ship. & handl. 
The Kit Includes: 

• Special Cable To Connect the Second Disk Drive. 

• 2 Integrated Circuits. 

t A Copy of HCM Vol. 4 No. 4 Containing Instructions. 

• Plus An Additional Update Sheet. 

—PCjr, Disk Drive, and Power Supply NOT hctuded— 



COMPUTER 
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Mt 



jr 
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PRICE 


SHIPPING 
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one add'l 
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3.50 


3.50 
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40 Blank SVa" Disks 


42.00 


3.50 


3.50 


DSK60 


60 Blank 5V*" Disks 


59.40 


3.50 


3.50 
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PCjr Disk Expansion Kit 
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3.50 
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ON DISK Revue Vol. 1 


14.95 


2.00 
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10" Monitor 


10.95 
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MX80 Printer 
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Cassette Recorder 
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TEXAS INSTRUMENTS 99 /4A CLOSE-OUTS 



ITEM NO. 


ITEM DESCIPTION 


PRICE 


SHIPPING 
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Best of 99'er 


19.95 


3.00 
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Bast Of 99'er— Book & Tape Combo 
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ppdJU.S. 


— 


BPG999 


Programmer's Guide 
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— 
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Simon's Saucer 
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12.95 


ZOO 


.50 


DUS76 


Tl Console 


8.95 


2,00 


.50 


DUS77 


Speech Synthesizer 


3.95 


zoo 


.50 


DUS78 


Disk Box Memory 


5.95 


2.00 


.50 


DUS79 


32K Memory Exp, 


5.95 


zoo 


.50 


DUSS0 


RSZ32 Interface 


5.95 


zoo 


.50 


DUSS1 


Disk Controller 


5.95 


2.00 


.50 


DU582 


Thermal Printer 


8.95 


2.00 


.50 












CBLtl 


Single Cassette Cable 


4.95 


1.50 


1.50 


CBL12 


Dual Cassette Cable 


4.95 


1.50 


1.50 



Complete the Subscription & Procuct Order Form and enclose payment or credit card information. Mail To; 

Emerald Valley Publishing Co. • P.O. Box 70288 • Eugene, OR 97401 
Or use our TOLL-FREE Order Line for VISA/ MasterCard orders only: 
1-600-828-2212 (Minimum $10 Order) In Oregon, Alaska, Hawaii Tel. {503} 485-8796 

HOURS: MONDAY THROUGH FRIDAY 7:00AM TO 4;00PM; SATURDAY 9:00AM TO 1.00PM P.S.T, 
Defective media gladly exchanged . NO REFUNDS on media. Offer & Prices Subject To Change Without Notice. Satisfaction 
Guaranteed— or trie unfilled portion of your subscription will 0e refunded, less She cost of any premiums you have received. 
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BLANK DISK MEDIA OFFER 

AS LOW AS 99<t EACH ! 

As a service to our readers who prefer to type-in 

HCM programs, we are able to offer high-quality 

blank diskettes at very low prices. 





20 
DISKS 

DSK30 


40 
DISKS 

DSK40 


60 
DISKS 

DSK&C 


BY* " certified single-sided, double 
density with reinforced hub ring. 
Bulk packed with white sleeves 
and indentification labels. 


$22.00 


$42.00 


$59.40 



PLUS S3.50 SHIPPING & HANDLING 



BACK ISSUES OF » 

99'er HOME COMPUTER 

MAGAZINE & MEDIA 

(The Forerunner of HCM) 





MAGAZINE PRICES' 


MAG 'MEDIA SET PRICES 


MEDIA PRICES 


QTY 


u 5 Canada Ftjfegsi* 


US. Canada HttlQr 


US Canada Ftortfn* 


J 
6 


S? 55 SID 95 S1095 


SlSyi S1995 $2! 95 


$10 95 $12.95 $14.95 


11295 $1695 $1895 


$29 50 $37 95 $39 95 


$2095 $22 95: $25 95 


12 


$2195 $29 95 $29 95 


$J9 95 $59 95 $63 95 


$3995. $44 95 $47 95 



t Magazines Shipped to Foreign Countries via Surface 
(Minimum Order of 3) 

— Partial Contents — 



issues no. 1-5 

OUT OF PRINT 

Contents available in 

book form as 
"Best of 99'er'— vol. 1. 

See Home Computer Digest 



THESE 2 MAGAZINES ARE 

OUT OF PRINT 

-TAPES AND DISKS 

ARE STILL AVAILABLE 
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HISTORICAL NOTE 

99'er Magazine (founded in December, 1980) was 
the forerunner of Home Computer Magazine. 
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A Giant Home Computer Compendium™ 
for the Texas Instruments 99/4A 

The largest, most comprehensive collection of programs 
and articles ever assembled for the Tl Home Computer 
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•Over 200 thoroughly tested key-in-and-RUN 
programs and sub-programs typeset in a grid 
format for maximum clarity. 

* Programming Instruction in 4 languages- 
learn to use BASIC, Extended BASIC, LOGO 
and Assembly Language — for everything 
from record keeping and money management 
to arcade-quality action games. 



• A selection of sensational game software 
featuring full-color graphics, animation, 
and sound effects. 

• Beyond the owner's manual — tips and 
techniques for getting the most out of 

your computer system. 

• Computer-Assisted Instruction — The home 
computer becomes your private tutor. 



• Page after page of innovative applications — transforming 
your computer into a home productivity center. 



Regular (Pre-Close-out) Prices: 



Best Of 99'er 
(Book alone) 

Best Of 99'er 
(Tape Set alone) 



$19.95 + $3.00 
shipping 

$35.00 + $2.50 
shipping 



SPECIAL 
OFFER 



► 



Buy the Tape Set for ONLY $35. 
And Get the Book FREE + 



FREE SHIPPING 

(Canada add S3.00) 




People Who Know the Home Computer Best 

HOME COMPUTER 

■■■■■nwaamaqazineHii 





SENSATIONAL SOFTWARE GIVEAWAY 



®YOUR CHOICE 
OF THIS ISSUE'S 
PROGRAMS AT A 
REMARKABLE PRICE- 
ONLY $4.95! 

plus $1.00 shipping & handling 

Price will change to $6.95 
upon becoming a Back Issue. M 



FOR SUBSCRIBERS & NEWSSTAND PURCHASERS ONLY* 

To participate in our monthly Software Giveaway, you need to be a 
bonafide purchaser of Home Computer Magazine. 
You will receive all the programs ON TAPE™ or ON DISK™ [which have 
versions for your selected machine) whose Jistings appear in this issue. 

IMPORTANT: Please complete the order form located in the center of this 
magazine. Enclose it in an envelope along with SS.95 (S6.95 in Canada, 
S 10,95 Foreign Airmail}, Payment must be made by check, money order, or 
VtSA/MasterCard. Proof of purchase (subscriber label number, sales receipt or 
any reasonable facsimile thereof) must also accompany this form, 
* Non-subscriber and non-purchaser price is SI 2.95 in the U.S. 



SORRY, WE CANNOT ACCEPT TELEPHONE ORDERS FOR THIS SERVICE. 






SAVE EVEN MORE! 

AND ENJOY THE 

CONVENIENCE 

OF A 

PROGRAM 

SUBSCRIPTION* 

By subscribing to ON TAPE™ or ON DISK™ you will 

save money off the single^opy price and receive the 

same high-quality programs published in each issue of 

the magazine— delivered right to your doorl 

This cassette tape or floppy disk program service is the 

convenient, accurate, and affordable way to save 

hundreds of typing hours. 

The Perfect Addition To 
Your Magazine Subscription! 

• Program Subscribers Get Disks & Tapes First 

To Coincide With Magazine Arrival. 

• Program Subscribers Get Special Updates As Available. 

•DOES NOT INCLUDE MAGAZINE 



*FREE SOFTWARE! 

When Subscribing To 




HOME COMPUTER 

■^^^^^■kMb^^h magazines 



Subscribe or Renew today, and with your paid subscription you will 
receive FREE software— ON TAPE™ or ON DISK™. With a 1-year 
subscription to Home Computer Magazine you get 2 FREE Issues 

fa s i r .90 Premium value) of ON TAPE™ or ON DISK™. Subscribe for 2 
years and receive 4 Issues [a $23.90 Premium value). And with a 3-year 
subscription we'll give you 6 full Issues fa 535.70 Premium value) of this 
convenient software on cassette tape or floppy disk. 

♦DON T HAVE A COMPUTER? TAKE A RAINCHECKI 

We'll give you a raincheck for the FREE software so that when you 
buy a computer, we will send you your choice of ON TAPE™ or ON 
DISK™ as a FREE BONUS as stated In this offer. 

And Yon Save Up To 40% Off The 
Single-Copy Price of the Magazine! 



TO ORDER: Please review these 3 Fantastic Offers 
and use the ORDER FORM located in the center of this magazine. 



® 



RECEIVE ALL the programs in this issue on magnetic media (see 
below). Indicate your choice of computer media on the order 
form and enclose S5.95 (S6.95 in Canada, SI 0.95 Foreign Airmail). 
THIS PRICE GOOD FOR THE CURRENT ISSUE ONLY 
Proof of purchase must be included with order 
FREE Software with your subscription to 

Home Computer Magazine for the terms listed below: 

■ 1-yr (10 issues) 525 ■ 2yr [20 issues) S45 ■ 3-yr (30 issues) S63 
PLUS 2 FREE PLUS 4 FREE PLUS 6 FREE 

ON TAPE or ON DJSK ON TAPE or ON DISK ON TAPE or ON DfSK 

Canada add J 7 per year; Foreign Surface add 521 for 

1-yr magazine subscription. Free software offer available In U.S. & Canada only. 

SAVE MONEY and time with a Program Subscription * 

to ON TAPE™ or ON DISK™ for the terms listed below; 

■ 8 ISSUES— ONLY $44.95 "An Extension To Your 2 Free Issues of Software" 

■ 10 ISSUES— ONLY $49.95 "A Full Year Of Program Convenience" 

*Does not include magazine. 

Canada add $5 for software subscription. 

Software subscription not available In other countries at this time. 

PLEASE LOCATE THIS BOX ON THE CENTER BOUND-IN ORDER FORM 
AND INDICATE YOUR CHOICE OF COMPUTER MEDIA 




DISK VERSION 


CASSETTE VERSION 


APPLE J ATARI 


C-64 


IBM PC IBM PCjr 


Tl 


ATARI i C-64 1 Tl 













Or ask for a raincheck for your FREE software. 



• 



SGV1550885 
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TAPE 
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The same high-quality Apple, Atari, Commodore, IBM, and Texas Instruments programs 
with type-in-and-RUN listings in this issue are now available ON DISK™ or ON TAPE™ 

to newsstand purchasers or subscribers of this magazine. 
For only $4,95* plus $1 .00 for shipping & handling, you receive all the programs for 
your particular brand of computer— rushed right to your door by First-Class mail; 

—Truly A "Software Giveaway!" 

For More Information. Sec ® Inside Rear Cover- 
To Order. Use The Bound-In Order Form At Center Of Magazine. Qiv Subject To Change WW mm 
Single-Issue Price Only - See I tenter Bound-In Order Form For Back-Issue Pi I rial Program Subscription I 



